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V Strade 

Questo mese ospitiamo le ultime puntate di ben due corsi: 
quello storico di C++ ed il più giovane, ma altrettanto valido, 
su Delphi. Non vi anticipo le novità con cui saranno sostituiti, 
vi dico solo che cercheremo di venire in contro alle richieste 
che da molti lettori sono giunte in merito al livello di difficoltà 
degli articoli. I passi che abbiamo in mente di compiere 
vogliono arrivare a snellire e rendere più "leggibili" gli articoli 
che finora sono sembrati più difficili da comprendere. 
Il nostro impegno è sempre stato quello di accelerare la curva 
di apprendimento delle tecnologie che proponiamo, attraver- 
so la sinergia fra una trattazione il più possibile chiara ed 
esempi applicativi che abbiano una reale impatto in ambito 
lavorativo o hobbistico. Ovviamente, non abbandoneremo 
questa strada: anche nel titolo di copertina di questo mese 
emergono le due anime di ioProgrammo. Da un lato la parte 
più professionale che guarda all'accessibilità dei siti, dall'altra 
la voglia di giocare con le tecnologie e meravigliare noi stessi: 
dare la voce ad un sito Web, spiegando sia come farlo cam- 
biando semplicemente i file audio da riprodurre, sia la tecno- 
logia lato server che può interessare ai più esperti. In realtà, 
questa dicotomia fra professionale e divertimento non ci è 
mai andata giù. Il nostro scopo è lavorare con entusiasmo e 
suscitare il vostro piacere di programmare. Le vostre mail e 
l'incredibile partecipazione al sito di ioProgrammo ci confer- 
mano nelle nostre scelte. Comunque, 
per qualsiasi correzione di rotta: 
attendo le vostre critiche! 

rdelmonaco@edmaster. it 
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All'inizio di ogni articolo, troverete un nuovo simbolo che indicherà la 
presenza di codice e/o software allegato, che saranno presenti sia sul CD 
(nella posizione di sempre \soft\codice\ e \soft\tools\) sia sul Web, all'indirizzo 
http: / / cdrom.ioprogrammo.it. 

Per scaricare software e codice da Internet, ogni mese indicheremo una 
password differente. Per il numero che avete fra le mani la combinazione è: 
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MICROSOFT 
E ORACLE 
ASSIEME PER 
LO SVILUPPO 

Idue giganti hanno siglato un 
accordo che prevede l'intre- 
grazione fra Visual Studio Net 
2003 ed il database Oracle. 
Dopo anni di feroce battaglia, 
l'accordo stretto fra i due gi- 
ganti consentirà agli sviluppa- 
tori di scrivere applicazioni per 
DB Oracle, utilizzando Visual 
Studio .Net 2003. 
Sembra dunque proseguire la 
strategia che vede Microsoft si- 
stemare pacificamente i conti 
con tutte le aziende che l'ave- 
vano veementemente attacca- 
ta in passato. 
www.oracle.com 

I DATABASE 
RIPRENDONO 
A CRESCERE 

Le vendite di database sono 
sempre state prese a misu- 
ra dello stato generale dell'in- 
dustria informatica. Nel 2002, 
la crisi del settore si era riflessa 
in un -6% delle vendite di DB, 
mentre il 2003 ha visto una 
crescita complessiva del 5%. 
Sugli scudi troviamo i soliti 
nomi: IBM, Oracle e Microsoft. 
DB2 di IBM guida la classifica 
con una quota del 36%, men- 
tre Oracle e Microsoft si fer- 
mano, rispettivamente, al 
32,6% e al 18,7%. Il database 
costituisce l'infrastruttura 
software che precede la co- 
struzione di qualsiasi nuovo 
progetto. Ecco perché e così 
importante valutare la dina- 
mica di questo mercato. Il 
crollo delle vendite dei DB nel 
2002 fu infatti diretta conse- 
guenza del disimpegno di 
molte aziende in nuovi pro- 
getti mentre oggi la prospetti- 
va è completamente diversa. 
Indicativo è lo straordinario 
aumento di database basati su 
Linux +100% nel 2003, au- 
mento che porta 300 milioni 
di dollari mercato comples- 
sivo dei DB Linux. 



JOBS E TIGER 
SARANNO LE STELLE 
DELLA WWDC 
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Sarà Steve Jobs ad aprire 
l'edizione 2004 della 
Worldwide Developers Con- 
ference, con un'anteprima 



di Mac OS X "Tiger" La key- 
note di quest'anno include- 
rà un'anteprima di "Tiger". 
L'evento, della durata di cin- 
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WWDC2004 

Worldwide Developers Conferente 



June 28 - July 2 in San Francisco, CA - Register today. 



Innovation never sleeps. 

Preview the highly evolved Mac OS X "Tiger." 

The Apple Worldwide Developers Conferente is the most important week o 
the year for developers, IT professionali, and digitai media authors. Apple 
CEO Steve Jobs will l-.ick off tlus -.-ear's conference with a keynote and 
unveil "Tiger," the next release ci Mac OS X — Apple's critically 
acclaimed operating system. Don't miss the opportuni tv to preview this 
new release and discover how Tiger will fusi the next generation of 
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WWDC In San Francisco, the "City oy the Bay." Register today. 



Flirchase ari E-ticket 
from the ADC 
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Explore WWDC 2004 
Select a fé atti re ... 



Registratimi and Pricing 

Gst informatoti about WWDC 
2004 ■ options. 



que giorni, avrà inizio il 28 
giugno e si concluderà il 2 
luglio, ospiterà quasi 200 
sessioni tecniche con nuovi 
contenuti studiati per soddi- 
sfare un'ampia gamma di 
sviluppatori Mac. 
Uno sguardo in profondità 
alle ultime tecnologie Mac 
OS X, laboratori "hands-on" 
con gli ultimi sistemi Mac, 
sezioni più estese per l'En- 
terprise IT e una sezione de- 
dicata per gli sviluppatori 
QuickTime e i creatori di 
contenuti. I partecipanti po- 
tranno toccare con mano le 
tecnologie di Mac OS X, sco- 
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CRACCATA 
LA CHIAVE 
CRITTOGRAFICA 
DA 576 BIT 

ra la scommessa ri- 
volta ai ricercatori da 
RSA Security: il crack 
della chiave crittografica 
lo si deve ad un team di 
matematici americani 
che, utilizzando un cen- 
tinaio di workstation e 
poco più di tre mesi di 
elaborazione, sono riu- 
sciti nell'impresa. 
"Le informazioni ricevu- 
te durante questi con- 
corsi costituiscono una 
risorsa di grande valore 
sia per chi studia la crit- 
tografia, sia per chi deve 
scegliere il giusto livello 
di sicurezza", ha affer- 
mato Burt Kaliski, chief 
scientist and director di 
RSA Laboratories. 



CELLE A COMBUSTIBILE 
GIÀ NELL'ANIMO 2005 



La ABI Research ha an- 
nunciato che cellulari, 
laptop e palmari, potreb- 
bero essere alimentati da 
celle a combustibile già dal 
2005. Le celle a combu- 
stibile (micro fuel 
cells o MFC) promet- 
tono una durata mol- 
to maggiore delle at- 
tuali batterie, ridu- 
cendo al contempo i 
tempi di rcarica. La 
ricerca ha evidenzia- 
to anche le incertez- 
ze di questa nuova 
tecnologia, incertez- 



ze che si rifletteranno in 
una lenta penetrazione del 
mercato: nel 2012, non più 
del 15 percento dei PC por- 
tatili saranno equipaggiati 
con MFC. 
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prendone le fondamenta open source 
le nuove applicazioni, e i tool di svilup- 
po di prossima generazione. Gli svilup- 
patori aziendali, gli amministratori di 
sistemi e gli IT manager potranno par- 
tecipare ad una sessione Enterprise IT 
più estesa, studiata specificamente per 
aiutare a capire le tecnologie chiave che 
saranno fornite in Tiger e sfruttarle ap- 
pieno nei loro ambienti. QuickTime e i 
Digital Media avranno acnhessi una 
sessione per sviluppatori e creatori di 
contenuti che vogliono esplorare le ulti- 
me tecnologie in ambito multimedia: 
distribuzione dei contenuti con Quick- 
Time Streaming Server, e nuovi tool e 
tecniche per la creazione e la distribu- 
zione di contenuti attraverso media di- 
gitali. Ovviamente, non mancheranno 
laboratori migliorati "hands-on" con gli 
ultimi sistemi Mac, dove gli sviluppato- 
ri potranno testare il loro codice e rice- 
vere assistenza tecnica dagli ingegneri 
Apple. 

httpMeveloper.apple.comA/vwdc/ 



INTEL SBATTE 



TERMICO 



Il più grande produttore di chip 
al mondo ha annunciato una 
svolta nello sviluppo dei futuri 
processori: due progetti (nome in 
codice Tejas e Jayhawk) saranno 
abbandonati a causa di un grave 
problema di fisica. In pratica, una 
sorta di muro termico impedisce 
l'aumento della velocità di clock 
oltre una certa soglia. 
Proprio sull'aumento della veloci- 
tà puntavano invece i due pro- 
getti abbandonati al loro posto, 
la nuova strategia di Intel pre- 
vede un più spinto parallelismo: 
si tenderà a integrare in un unico 
chip sempre più processori, in 



modo da bilanciare le difficoltà 
nell'aumentare la velocità di 
clock. 

www.intel.com 
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BEA, IL FUTURO E LIQUIDO 



Il tema della eWorld conference 
di quest'anno è la Service 
Oriented Architecture (SOA). 
Nella keynote di apertura Alfred 
Chuang, presidente di BEA, ha 
lanciato il messaggio sottolineato 
l'importanza di cominciare, da su- 
bito, a sviluppare in ambito SOA. 
Gli ultimi sforzi di BEA sono stati 
tutti volti a rendere WebLogic più 
facile da interfacciare con appli- 
cazioni prodotte da 
terze parti. Sempre 
secondo Chuang, l'o- 
biettivo comune di 
BEA e degli sviluppa- 
tori sarà quello di rag- 
giungere il "Liquid 
Computing": sistemi 
flessibili al punto da 
adattarsi da soli a 
qualsiasi ostacolo, ag- 
girandolo. Come fos- 
sero fluidi, appunto. 
Il continuo aggiorna- 
mento cui è sottopo- 



sto ormai ogni sistema software 
deve dunque in qualche modo 
"automatizzarsi": sistemi adattivi 
dovranno consentire l'adegua- 
mento al mutamento delle esi- 
genze e dell'ambiente a costo ze- 
ro. In questa ottica, l'architettura 
Services Oriented è solo il primo 
passo verso il reale obiettivo: il li- 
quid computing. 

www.bea.com 




MICROSOFT 
TECHED 2004 
EUROPE 

Dal 29 giugno al 2 luglio 2004, Am- 
sterdam sarà invasa da migliaia di 
sviluppatori, la città sarà infatti teatro 
del principale appuntamento europeo 
di Microsoft: il Teched 2004. Per svi- 
luppatori ed i professionisti dell'IT sarà 
l'occasione per approfondire temi legati 
allo sviluppo applicativo, al deployment, 
alla sicurezza e alla gestione di soluzioni 
pensate per soddisfare le esigenze di bu- 
siness. 

Si avrà modo di vedere in azione sia tec- 
nologie e prodotti già rilasciati sia quelli 
disponibili nell'arco dei sei mesi succes- 
sivi all'evento. La conferenza consiste di 
4 giornate precedute da una pre-confe- 
rence il 28 giugno 2004. Come sempre, 
ioProgrammo coprirà l'evento con re- 
portage e interviste in esclusiva. 

www. microsoft, com 
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MOTORI DI RICERCA 

LA SFIDA DEL MULTIMEDIA 



I contenuti testuali sono stati, da sem- 
pre, la colonna portante di Internet. 
La generazione di Internet ha vissuto 
un vero e proprio ritorno alla parola 
stampata: dopo anni in cui televisione 
e cinema avevano quasi del tutto sop- 
piantato la comunicazione scritta, il 
testo è tornato prepotentemente alla 
ribalta. Ma, come diciamo da molto 
tempo, questa condizione non è desti- 
nata a durare ancora molto: la larghez- 
za di banda consente (e consentirà 
sempre più) la diffusione di contenuti 
multimediali (essenzialmente audio e 
filmati) che, oltre a cambiare la natura 
"sociologica" di Internet, ne modifi- 
cheranno dal profondo alcune caratte- 
ristiche eminentemente tecniche. Una 
su tutte: le ricerche, faranno i motori di 
ricerca a estrapolare ed archiviare la 
massa di informazioni audiovisiva 
che si sta riversando nell'universo ►► 




RILASCIATO 
FILEMAKER SERVER 7 




Grandi 
perfor- 



mance per il 
nuovo soft- 
ware server 
di FileMa- 
ker, che può 
ospitare una 
quantità di 
dati illimitata offrendo la massima fa- 
cilità nella gestione dei database con- 
divisi. FileMaker Server 7 consente di 
gestire e condividere i database creati 
con FileMakerPro 7 ed è finalmente 
disponibile sul mercato italiano. Ad 
annunciarlo, FileMaker Inc., azienda 
californiana leader mondiale nella 
produzione di software database per 
workgroup aziendali e singoli utenti. 
Ryan Rosemberg, Vice Presidente del- 
la divisione Marketing and Service di 



FileMaker ha dichiarato: "FileMaker 
Server 7 permette alla piccolissima 
azienda così come alla grande realtà 
imprenditoriale con più gruppi di la- 
voro di condividere, gestire e accede- 
re alle informazioni contenute nel da- 
tabase in modo semplice offrendo la 
massima produttività". FileMaker 
Server 7 assicura numerosi potenzia- 
menti tecnologici per condividere i 
dati e per la loro amministrazione, ol- 
tre ad offrire funzioni avanzate in gra- 
do di proteggere le informazioni. 
FileMaker Server 7 ha una nuova fun- 
zione che permette di eseguire le ri- 
cerche e i calcoli direttamente sul ser- 
ver, invece che sul client; per questo é 
in grado di gestire i database in modo 
più rapido, ottimizzando, inoltre, i si- 
stemi di memorizzazione dell'hard 
disk e dei server multi- CPU. Un altro 



vantaggio offerto dalla nuova versio- 
ne é la grande quantità di RAM sem- 
pre disponibile, procedimento otte- 
nuto mediante i nuovi e sofisticati si- 
stemi di caching. 

FileMaker Server 7 può ospitare sino 
a 125 file di database e ogni database 
è in grado di memorizzare fino a 8 te- 
rabyte di informazioni, una capacità 
4.000 volte superiore al precedente li- 
mite. 

Ogni file del database può ora con- 
tenere tabelle multiple di dati, e un 
singolo FileMaker Server puòospitare 
milioni di tabelle. Per espanderne ul- 
teriormente la capacità, l'utente può 
aggiungere ulteriori FileMaker Server 
al proprio network a seconda delle 
esigenze di crescita del business. 

wwwl. filemaker. fr/italy/products/ 
fms_home.html 
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►► Internet? Attualmente, la 
catalogazione delle informa- 
zione multimediali si poggia 
semplicemente sulla descri- 
zione testuale che accompa- 
gna i filmati e i file audio pre- 
senti sul Web. Anche la ricer- 
ca per immagini presente in 
Google e in altri motori di ri- 
cerca si basa sul nome del file 
o sulle descrizioni che si tro- 
vano nelle vicinanze dell'im- 
magine nella pagina Web ori- 
ginale. La catalogazione non 
è dunque effettuata diretta- 
mente sull'immagine, o sui 
contributi audio-video, ma 
sul testo che li accompagna. 
Tutti i principali motori di ri- 
cerca, Google in testa, sono 
impegnati nello sviluppo di 
tecnologie che consentano di 
estrapolare dati utili alle ri- 



cerche direttamente dalle 
fonti audio-video. In questa 
corsa, una piccola compa- 
gnia, la SreamSage, sembra 
aver accumulato un discreto 
vantaggio: la tecnologia che 
ha sviluppato si occupa di 
trascrivere il parlato presente 
nei contributi audio, consen- 
tendo la ricerca sulla reale 
fonte. I risultati della ricerca 
non solo indicano in quali fi- 
le è presente il testo cercato 
ma evidenziano anche il pun- 
to del file in cui è citata la 
chiave di ricerca. In via speri- 
mentale, potete provare il 
servizio su www.campaign- 
search.com, in cui sono stati 
catalogati i discorsi dei due 
candidati alle prossime ele- 
zioni americane. 

www.streamsage.com 



CA RIVELA IL 
CODICE DI INGRES 

La Computer Associates ha annunciato il rilascio 
del codice del suo popolare database Ingres. 
Sede dell'annuncio è stato il CA World del maggio 
scorso: chiaro segno dell'attenzione che CA rivol- 
ge al movimento Open Source e a Linux. Ad ac- 
compagnare il rilascio del codice, è stata messa a 
punto nuova licenza: CA Trusted Open Source Li- 
cense (CA-TOSL). CA lascia dunque intuire che sa- 
ranno rilasciati ulteriori software con licenza 
Open Source, seguendo una strategia che dopo 
IBM, comincia a tentare anche Microsoft. 

www.ca.com 



Thank you for makìng 
caworld a huge success. 
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CRYSTAL E OFFICE 

UN'ACCOPPIATA 

VANTAGGIOSA 



A M'ultimo TechEd ame- 
>, il 26 maggio 
scorso. Business Objects 
ha annunciato il rilascio 
di numerosi nuovi pro- 
dotti che si vanno ad in- 
tegrare con l'offerta Mi- 
crosoft per l'ufficio. 
Di particolare rilievo, Cry- 
stal Enterprise Live 
Office: una soluzione che 
permette agli utenti di in- 
corporare dati provenien- 
ti da Crystal Report all'in- 
terno di documenti Offi- 
ce. 

I dati integrati in Word, 
Excel, Powerpoint o Out- 
look, saranno costante- 
mente aggiornati, in mo- 
do da poter essere defi- 
niti "vivi": diventa così 
possibile garantire il 
continuo aggiornamen- 
to e la consistenza delle 
informazioni presenti 



nelle migliaia di docu- 
menti che circolano ogni 
giorno nelle aziende. 
Tutti i documenti corre- 
lati a dati prodotti attra- 
verso Crystal Enterprise 
Live Office risulteranno 
allineati costantemente. 
Nell'ambito delle inte- 
grazioni, non poteva 
mancare un prodotto 
che facesse esplicito rife- 
rimento a SharePoint 
Portai Server 2003: Cry- 
stal, nella versione 10, si 
inserisce ora perfetta- 
mente in SharePoint at- 
traverso un kit di inte- 
grazione che consente 
l'accesso sicuro alle in- 
formazioni distribuite su 
diversi sistemi, ivi com- 
prese applicazioni CRM 
(customer relationship 
management). 

www.businessobjects.com 



J2EE 1.5 

OBIETTIVO 

SEMPLICITÀ 



La facilità di sviluppo sa- 
rà al centro della versio- 
ne 1.5 di Java 2 Enterprise 
Edition, successore dell'at- 
tuale J2EE 1.4. 
Sul modello di J2SE 1.5, a 
breve disponibile in versio- 
ne definitiva, J2EE 1.5 aiu- 
terà i programmatori con il 
supporto dei metadati e dei 
generics. 

I metadati consentiranno 
di migliorare la flessibilità 
delle applicazioni attraver- 
so classi più facilmente in- 
tegrabili in ambienti ete- 
rogenei. 

II supporto per XML ed 
UML diverrà parte inte- 
grante del linguaggio, an- 
dando a vantaggio proprio 
delle applicazioni enterpri- 
se cui J2EE è rivolto. 
Anche l'introduzione dei 



generics migliorerà la fles- 
sibilità delle classi, consen- 
tendo di realizzare fun- 
zionalità che possano agire 
su molteplici tipi di dato. 
Finora, J2EE 1.5 è stato 
spesso indicato come la 
versione Web Services 
oriented di J2EE, ma i mi- 
glioramenti apportati sot- 
tolineano quanto sia stata 
giudicata critica anche la 
facilità di sviluppo. 
In questa direzione, Sun ha 
anche rilasciato Java Studio 
Creator; con questo ultimo 
rilascio lo scopo non di- 
chiarato è di colmare il gap 
nei confronti della piat- 
taforma .Net che, a dispetto 
di una base di installato 
molto più ridotta, ha nella 
semplicità il motivo di at- 
trattiva più valido. 
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Webb.it 2004 




Webb.it 

Ecco com'è andata 

Grande successo di pubblico, lo scorso Maggio per lo stand 
di ioProgrammo presente al Webb.it di Padova insieme 
al simpatico Sony Aibo. 



di Alfredo Marroccelli 




Possiamo ben dire che la tre-giorni 
padovana di ioProgrammo al Web- 
b.it sia stata una bella soddisfazio- 
ne per chi scrive, una manifestazione di 
affetto e partecipazione da parte dei tantis- 
simi lettori che hanno avuto piacere nel 
fermarsi nello stand della loro rivista di 
programmazione preferita. ioProgrammo 
è stata presente aWebb.it, la fiera-incontro 
dell'informatica svoltasi il 6, 7 e 8 Maggio. 




L'occasione è stata la collaborazione con il 
progetto annuale sviluppato dallo staff di 
Webb.it, che quest'anno ha riguardato la 
programmazione dell'Albo ERS-7, il sim- 
patico robot-cagnolino di casa Sony, che in 
realtà è un vero e proprio concentrato di 
tecnologia, nonché l'oggetto del desiderio 
di ogni appassionato di robotica. 
Il concorso promosso da ioProgrammo, 



proposto sul numero di Aprile, ha consen- 
tito a diversi lettori di provare il loro codice 
(l'Albo è programmabile in C++, come 
forse già saprete dalle lezioni pubblicate in 
passato su questo argomento) e alle perso- 
ne che popolavano lo stand di divertirsi 
guardando le evoluzioni del robottino. 




L'Aibo è in grado (nella versione "ludica" 
del suo software interno) di intrattenere 
chi lo osserva producendosi in danze rit- 
miche, accompagnate da una musichetta 
che egli stesso riproduce tramite uno spea- 
ker interno, giocare con il suo osso colora- 
to, tirare calcetti alla sua pallina rosa e fare 
molte altre cose "intelligenti" tra cui, ad 
esempio, cercare autonomamente la ba- 
setta di carica quando le sue batterie sono 
agli sgoccioli. 





È stata forse proprio la sua accattivante 
indole giocherellona a rendere una vera at- 
trazione il nostro "Bubi", nome col quale è 
stato prontamente ribattezzato l'Albo per 
potere facilmente rispondere ai comandi 
vocali che gli venivano impartiti (un vero 
tormentone il "Bubi, let's go dancing!" 
ripetuto con frequenza impressionante dai 
passanti che volevano vederlo ballare). 
Bubi è riuscito a strappare un sorriso 
anche ai più seriosi che si avvicinavano col 
sano scetticismo che contraddistingue chi 
del mondo dell'informatica ha fatto il suo 
mestiere. Desideriamo ringraziare di cuore 




tutte le persone che hanno contribuito alla 
buona riuscita di questa iniziativa e soprat- 
tutto i lettori, vecchi e nuovi, che sono 
venuti a trovarci. Alla prossima! 
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Eclipse 3.0 M9 

Lo stato dell'arte per lo sviluppo Java 



di Federico Mestrone 



Sul CD allegato ad ioProgrammo con 
questo numero vi viene proposto un 
interessante tool di sviluppo Java dalla 
sorprendenti capacità. Si tratta del proget- 
to Eclipse, inizialmente di proprietà IBM e 
da questa donato alla comunità open- 
source. Tale progetto consta in una raccol- 
ta di vari tipi di sottoprogetti che in realtà 
insieme formano, più che un software per 
lo sviluppo, un framework per la creazione 
di ambienti integrati di sviluppo per qua- 




Fig. 1: La finestra di benvenuto di Eclipse 
3.0 M9. 



lunque linguaggio e piattaforma. Ma la 
ragione per cui Eclipse sta avendo molto 
successo - che è anche la ragione per cui è 
a me particolarmente caro - sta appunto 
nell'IDE per la creazione di applicazioni 
Java, il quale, offerto di fatto come esem- 
pio di uso del framework che Eclipse 
mette a disposizione, è riuscito a imporsi 
come prodotto di alta qualità e di livello 
decisamente commerciale, pur essendo 
completamente gratuito. La nostta atten- 
zione sarà quindi rivolta all'IDE Java di 
Eclipse, ed in particolare ci soffermeremo 
sulla versione 3 del prodotto: sul CD trova- 
te la 3M9, ultima build disponibile al 
momento della pubblicazione della rivi- 
sta. Si tratta di una versione stabile, perfet- 
tamente utilizzabile anche per ambienti di 
produzione, ma non ancora un rilascio 
definitivo di Eclipse 3. Presenta dei signifi- 
cativi miglioramenti rispetto all'attuale 
versione in rilascio ufficiale (2.1.3) in ter- 
mini di semplicità d'uso, configurabilità e 
funzionalità offerte ed è per questo che ne 



parliamo in questa sede: tenete anche 
conto del fatto che non ci saranno diffe- 
renze sostanziali rispetto al rilascio defini- 
tivo, se non bug-fix e ripulitura del codice. 



INSTALLAZIONE 
E PRIMO UTILIZZO 

Per cominciare, l'installazione del pro- 
dotto è veramente molto semplice. 
Dovete assicurarvi che sia installato sulla 
vostra macchina un JDK pari o superiore 
al 1.4.1, dopodiché potete scaricate il file 
.zip dal sito ufficiale www.eclipse.org 
(oppure evitate i tempi d'attesa e prende- 
telo dal CD!) ed estrarlo direttamente 
dove volete installare il prodotto finito! 
Tra i vari file estratti troverete l'eseguibile 
eclipse.exe da lanciare per fare partire 
FIDE. All'avvio di Eclipse, dopo la richie- 
sta della directory del workspace dove 
verranno tenuti i vostri progetti (lasciate 
pure il default), vi accoglierà la scherma- 



CREARE E TESTARE UN'APPLICAZIONE JAVA CON ECLIPSE 






Seletl a wizard 

Creale a Java project 



Q Selezionate File->New->Project per 
creare un nuovo progetto. Dalla 
finestra New Project che vi si apre, sce- 
gliete poi Java Project e cliccate sul pul- 
sante Next in basso sulla finestra per 
procedere al passo successivo. 
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HDate un nome al vostro proget- 
to. Questo sarà anche il nome 
della cartella dentro cui verrà tenuto 
il materiale che sviluppate. Lasciate le 
altre opzioni invariate. Premete il pul- 
sante Next. 









HQui potete specificare eventuali libre- 
rie aggiuntive per la compilazione del 
vostro progetto. Nel nostro caso, non c'è 
bisogno di indicare nulla: premete il pulsan- 
te Finish. Alla finestra di pop-up che chiede 
se passare alla prospettiva Java, dite di sì. 
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ta di benvenuto (la trovate in Fig. 1) con 
vari link ad elementi di aiuto e supporto 
per chi è nuovo all'ambiente. Chiudendo 
la finestra Welcome vi ritroverete invece 
nell'IDE vero e proprio. Eclipse tenta di 
agevolare il lavoro del programmatore 
organizzando i vari elementi offerti in 
prospettive (perspective): ogni prospetti- 
va è un insieme di viste (view), cioè di 
finestre che offrono le più svariate fun- 
zionalità (explorer del repository di pro- 
getti, outline delle classi sviluppate, elen- 
co dei package di un progetto, gerarchia 
delle classi, problemi di compilazione, 
etc), permettendo così al programmatore 
di lavorare secondo le sue esigenze: la 
prospettiva Java per scrivere il codice, 
quella Debug per fare il debug delle 
applicazioni, quella dedicata al team syn- 
chronising per lavorare con repository 
CVS, e via dicendo. Una piccola toolbar 
in alto a destra della finestra dell'IDE vi 
consente di aprire le varie prospettive e 
di passare tra una e l'altra. 



UTILIZZARLO 
AL MEGLIO 

Come buona parte degli ambienti di svi- 
luppo disponibili, Eclipse propone un 
editor integrato con syntax coloring, com- 
pletamente configurabile (menu Win- 
dow->Preferences, poi Java->Editor, pagi- 
na Syntax, come in Fig. 2) ed una como- 
dissima funzione di formattazione del 
codice, anch'essa completamente confi- 
gurabile con un numero di opzioni im- 
pressionante (menu Window->Preferen- 
ces, poi Java->Code Style->Code Format- 
ter, create un profilo personalizzato e clic- 
cate su Edit, come in Fig. 3) che prende 



tutto quello che avete scritto e lo sistema 
in base alle vostre scelte e alle convenzio- 
ni di stesura del codice previste da Java: 
basta premere CTRL +SHIFT+F durante 
l'editazione (mette in ordine indentazio- 
ni, spaziature, ritorni a capo, tutto insom- 
ma: è davvero ben fatto ed è una gran 
cosa per chi, come me, ci tiene ad avere il 
codice scritto in maniera pulita e leggibi- 
le). 
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Fig. 2: Le opzioni di syntax colouring offerte 
da Eclipse per l'editing Java. 

Un'altra comodissima ed innovativa ca- 
ratteristica di Eclipse è quella di mostrare 
sempre tutti gli eventuali problemi di 
compilazione del vostro codice nella view 
dei problemi (problems view), grazie alla 
compilazione automatica delle classi che 
viene fatta ad ogni salvataggio del vostro 
lavoro (con CTRL+S). In questa maniera, 
ogni volta che salvate avete un immedia- 
to feedback sulla correttezza di quanto 
digitato: è quindi una buona idea abituar- 
si a salvare molto spesso, oltre che per evi- 
tare spiacevoli perdite qualora venisse a 
mancare la corrente, anche per verificare 
subito la reazione del compilatore a quel- 
lo che abbiamo scritto. 



UHI VALIDO AIUTO 

Per finire, non potendo in poco spazio 
elencare tutte le potenzialità di questo 
eccezionale prodotto, parliamo almeno 
di dove potete trovare aiuto: allo stesso 
livello degli ambienti di sviluppo che si 
pagano centinaia di dollari, Eclipse 
mette a disposizione una guida online 
completa e dettagliata delle sue caratte- 
ristiche. 
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Fig. 3: La finestra a più pagine per 
l'impostazione del code formatter. 



Se volete scoprire i trucchetti più interes- 
santi per essere più produttivi, date 
un'occhiata ai "tips and tricks" (menu 
Help-> Tips and Tricks poi scegliete l'a- 
rea d'interesse), mentre per il classico 
aiuto stile manuale, dal menu seleziona- 
te Help-> Help Contents. 



Eclipse 3.0M9 

Produttore: consorzio ecliplse.org 
Sul web: www.eclipse.org 
Prezzo: Gratuito 
Nel CD: Eclipse 
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□ Nella view Navigator, cliccate con 
il destro sul vostro nuovo proget- 
to e selezionate il menu New->Class. Si 
apre così la finestra New Java Class 
dove potete definire una nuova classe 
Java per il vostro progetto. Selezionate 
la spunta per creare il metodo main e 
date un nome alla classe ed al suo 
package. Poi premete il pulsante Finish. 
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HA questo punto non resta che scri- 
vere il codice della classe appena 
creata. Qui per esempio mettiamo un 
semplice System.out.println (Quello che 
voglio scrivere); all'interno del metodo 
main che è stato generato automatica- 
mente, giusto per testare. A questo punto 
selezionate dalla barra del menu Run- 
>Debug e vi si aprirà la finestra Debug. 
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H Selezionate Java Application, un clic 
su New, e verrà creata una nuova 
configurazione per l'esecuzione di applica- 
zioni con metodo main. Selezionate il 
vostro progetto con Browse e lasciate che 
Eclipse trovi le classi con main, cliccando 
su Search (voi ne avete solo una!). Poi pre- 
mete Debug. Il risultato dell'esecuzione 
della vostra classe nella view Console. 
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Eclipse ME 



Il plug-in per Eclipse che consente di sviluppare in J2ME. 



di Federico Mestrone 



Tra il software a disposizione dei lettori 
questo bimestre, visto che è stato 
offerto Eclipse, recensito nelle pagine pre- 
cedenti, abbiamo pensato di proporre 
anche un plug-in da installare sotto la sua 
piattaforma di sviluppo: EclipseME, un 
valido aiuto per chi si vuole cimentare 
nello sviluppo di applicazioni fava desti- 
nate ai dispostivi mobili, tipo i cellulari 
dotati di supporto per la piattaforma 
J2ME. 



SVILUPPO MOBILE 
ini JAVA 

Se vi ricordate (altrimenti potete ri- 
prendere l'articolo del numero 81 di 
ioProgrammo, a pagina 26, dedicato 
all'argomento), il J2ME è il framework 
di sviluppo proposto dalla Sun per lo 
sviluppo di MIDlet, termine con cui si 
definiscono le applicazioni che girano 
all'interno delle macchine virtuali lava 
predisposte per gli apparecchi wire- 
less. Si tratta semplicemente di classi 
Java: potete immaginare questi MIDlet 
come se fossero degli applet ma, in- 
vece che essere eseguiti dentro un 
browser, essi hanno bisogno di un cel- 
lulare. I vari MIDlet che fanno parte di 
una stessa collezione applicativa sono 
raggruppati in un JAR associato ad un 
deployment descriptor (file di descri- 
zione in formato XML) detto JAD, e nel 
complesso JAR e JAD sono chiamati 
MIDlet Suite. Da un altro lato, invece, 
dobbiamo parlare del concetto di 
plug-in di Eclipse. Il progetto Eclipse è 
un framework estensibile a mezzo di 
questi "plug-in", che possiamo definire 
come delle aggiunte al prodotto base 
che mettono a disposizione fun- 
zionalità e caratteristiche supplemen- 
tari, per cui non sapremo mai dove 
finiscono le capacità di Eclipse, perché 
questo dipende dal numero e dalle 
funzionalità dei plug-in che vengono 
sviluppati per esso. Se volete farvi un'i- 
dea di cosa c'è a disposizione in giro 
per la rete, fate un salto all'indirizzo 
www.eclipseplugincentral.com. 



UHI PLUG-IN CHE 
SEMPLIFICA LE COSE 

Quello che trovate sul CD allegato a questo 
numero, dunque, è un plug-in per Eclipse 
che permette a chi sviluppa di creare rapi- 
damente lo scheletro di una applicazione 
J2ME. Un wizard specifico genera un pro- 
getto IDE che corrisponde ad una MIDlet 
Suite, con tanto di JAD editabile a mezzo 
di una finestra di proprietà, invece che di- 
rettamente dal codice XML, e un altro 
wizard genera invece la struttura basilare 
di una classe MIDlet, lasciando così a voi il 
solo compito di scrivere il codice per la 
funzionalità che intendete offrire. Alcuni 
menu contestuali che il plug-in aggiunge 
si occupano poi di generare quella combi- 
nazione JAR + JAD che può essere scarica- 
ta sul vostro cellulare, di eseguire i MIDlet 
sotto un emulatore di dispositivo mobile, 
ed altro ancora. Come ultima cosa, il plug- 
in si garantisce anche di fare le pre-verifica 
del codice Java: se ricordate dall'articolo 
sul J2ME menzionato più in alto, le mac- 
chine virtuali degli apparecchi wireless (le 
KVM) sono molto leggere e non si possono 
permettere di controllare l'integrità e vali- 
dità del codice compilato, come fanno in- 
vece trasparentemente le JVM standard: è 
necessario perciò che il codice venga pre- 
verificato prima dell'installazione ed ese- 
cuzione, aggiungendo carico al lavoro del 
programmatore. Ma come già detto, Eclip- 
seME fa tutto questo per voi. 



LA PRIMA 
APPLICAZIONE 

Vediamo adesso, a semplici passi, cosa 
fare per renderci operativi come sviluppa- 
tori I2ME. Partirò dal presupposto che 
Java ed Eclipse siano già installati. Dobbia- 
mo allora installare il JDK per J2ME, che ci 
metterà a disposizione le interfacce per lo 
sviluppo ed un emulatore di cellulare di 
test: scaricate il prodotto dalla Sun all'indi- 
rizzo http://java.sun.com/products/j2mew- 
toolkitldownload-2_l.html, ed eseguite il 
file ricevuto. La procedura di installazione 
dovrebbe rilevare automaticamente il JDK 



che avete e vi permetterà di scegliere la di- 
rectory dove installare il Wireless Develop- 
ment Toolkit: lasciate quella di default, 
C:\WTK21. Ad installazione avvenuta, 
possiamo passare ad EclipseME. 

1) Scaricate il plug-in dal sito http://eclipse- 
me.sourceforge.net, oppure utilizzate la 
versione che trovate sul CD allegato ad io- 
Programmo. Per installare il prodotto, 
dovete soltanto estrarre il file compresso 
scaricato dentro la cartella plugins che tro- 
vate sotto la directory di installazione di 
Eclipse. Alla fine dell'estrazione, dentro 
plugins dovrete avere una cartella eclipse- 
me_0.4.0. Se la versione che avete voi fosse 
una successiva alla 0.4, ovviamente il 
nome della directory sarebbe differente! 




Fig. 1: II plug-in è installato correttamente! 

2) Una volta (ri)awiato Eclipse dopo l'ag- 
giunta del plug-in, controllate se l'installa- 
zione è stata portata a termine corretta- 
mente: aprite la pagina delle preferenze 
(Window->Preferences...) e verificate di 
avere una nuova voce J2ME nella lista del- 
le opzioni, come vedete in Fig. 1. Questa 
voce, aggiunta da EclipseME, è segno che 
adesso il plug-in è installato ed attivo. Re- 
state in questa finestra. 







Fig. 2: Indichiamo la posizione del toolkit. 

3) Dobbiamo adesso indicare ad Eclipse- 
ME dove si trova il nostro Wireless Toolkit. 
Per fare questo, passate alla pagina dei 
toolkit cliccando sulla voce Platform Com- 
ponents, cliccate poi col destro su Wireless 



*> 14/ Luglio-Agosto 2004 



http://www.ioprogrammo.it 



Tool di sviluppo ■ T SOFTWARE SUL CD 



Toolkits per mostrare il menu contestuale 
Add Wireless Toolkit, come vedete in Fig. 2. 
Selezionando la voce di tale menu conte- 
stuale, vi verrà richiesta la directory dove 
avete installato il prodotto della Sun, che 
per default è C:\WTK21, ed EclipseME 
identificherà così il toolkit per lo sviluppo 
J2ME (come in Fig. 3). Premete il pulsante 
Finish sulla finestra Add Wireless Toolkit, e 
poi pulsante Ok sulla finestra Preferen- 
ces. Ora siamo pronti per sviluppare il no- 
stro primo MIDlet. 



EEOBB1 



Wireless Toolkit Directory 

5pecify the root directory of the wireless toolkit 

Wireless Toolkit Directory 

| C:\WTK21 

]2ME Wireless Toolkit 2 1 



Fig. 3: II toolkit standard di Sun. 

4) Dovreste essere adesso di nuovo nel 
workbench (la finestra principale). Dalla 
barra del menu in alto, aprite il menu File- 
>New->Project. . . e dalla finestra New Pro- 
ject selezionate la voce J2ME MIDlet Suite 
(la vedete in Fig. 4, è stata aggiunta alla li- 
sta grazie al plug-in appena installato). 
Cliccate su Next e date un nome al vostro 
progetto, per esempio "MiaMidletSuite". 
Ora cliccate su Next e scegliete una piat- 
taforma MIDP per lo sviluppo (vedi Fig. 5, 
dove viene scelto MIDP 2.0). Nella pagina 
che segue (Fig. 6), potete aggiungere even- 
tuali librerie per la vostra applicazione 
J2ME. Notate che è stato impostato un fil- 
tro che non mostra il materiale di lavoro 
del plugin (directory verified e deployed), 
rendendo così più pulita la lista di file con 
cui il programmatore avrà a che fare nelle 
varie view. 



MIDlet, che trovate in Fig. 8. Qui dovete 
solo dare un nome al package e alla classe 
che volete creare ed indicare che la vostra 
classe implementerà l'interfaccia Com- 
mandListener (cliccate sul pulsante Add, 
nella finestra che compare scrivete "Com- 
mandListener" e cliccate Add e dose): le 
altre opzioni possono essere lasciate al lo- 
ro default. Cliccando su Finish verrà gene- 
rata una nuova classe per il vostro MIDlet 
e la stessa sarà aperta nell'editor per il vo- 
stro sviluppo. 
6) Alla classe appena creata aggiungete i 



Piallimi DrlHNtHiri 
Jwx* CN: p4otf orni Dohnfiwi far Che protKt. 
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Fig. 5: La scelta della piattaforma. 

seguenti statement di import: 

import javax.microedition. Icdui. Screen; 
import javax.microedition. Icdui.TextBox; 
import javax.microedition. Icdui. Display; 
import javax.microedition. Icdui.TextField; 
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Fig. 6: L'ossatura della Midlet Suite è 
pronta. 

7) Aggiungete poi la seguente variabile di 
istanza 



myScreen = new TextBox("Welcome", 

"Questo è il mio primo MIDlet!", 100, 

TextField.ANY); 

myScreen. addCommand(cmdExit); 
myScreen. setCommandListener(this); 
d.setCurrent(myScreen);} 
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Fig. 8: L'ultimo passo nel Wizard. 

9) Infine inserite il codice seguente come 
implementazione del metodo command- 
Action 

if ( argO == cmdExit ) { 

try{ 

destroyApp(false); 
notifyDestroyedQ; 
} catch (MIDIetStateChangeException msce) 

O 

} 




Fig. 9: Il nostro Midlet in azione. 
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Fig. 4: Il primo passo per costruire 
un 'applicazione. 

5) Adesso, dalla view Package Explorer (se 
non la vedete, aprite la prospettiva Java), 
cliccate col destro sul nuovo progetto 
J2ME che avete creato e selezionate New- 
>Other. . . per far comparire la finestra New 
della Fig. 7. Da questa finestra scegliete la 
voce J2ME MIDlet, anch'essa parte del plu- 
gin EclipseME. Cliccando Next vi si aprirà 
la finestra di creazione di un nuovo 



private Command cmdExit = new 

Command("Esci",Command.EXIT,0); 




Fig. 7: E' il momento del Midlet. 

8) Implementate il metodo startApp con 
questo codice 

Screen myScreen = nuli; 

Display d = Display.getDisplay(this); 

if (d.getCurrent() == nuli) { 



Ora non resta che eseguire il nostro codi- 
ce in un emulatore di cellulare messo a 
disposizione dal Wireless Toolkit ed utiliz- 
zabile tramite EclipseME. Dopo aver sele- 
zionato la classe MIDlet che abbiamo ter- 
minato di scrivere, cliccate sul menu 
Run->Debug as->Emulated J2ME Midlet e 
dopo qualche secondo si aprirà un cellu- 
lare virtuale come quello della Fig. 9, con 
il vostro MIDlet in esecuzione. 






[ZI Eclipse ME 

Produttore: Eclipse.org 

Sul Web: www.eclipse.org 

Licenza: Open Source 

Nel CD: eclipseme-0.4. ì.zip 

Esempi nel CD: \codice\SimpleMidletjava 
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Ace OS 2.0 Beta 

Il sistema operativo Open Source tutto da e studiare. 



Ace OS è un nuovo sistema operativo 
libero distribuito con licenza GNU 
GPL. Lo scopo degli sviluppatori è prin- 
cipalmente quello di creare un sistema 
operativo per fini didattici e di ricerca, 
per far sì che si possano "studiare" la 
struttura ed i meccanismi che agiscono 
all'interno di un sistema operativo e del 
suo componente principale, il kernel. Il 
progetto, pur essendo stato avviato da 
qualche anno, è ancora nella fase inizia- 
le di sviluppo, non può essere certa- 
mente considerato un sistema operati- 
vo completo nel senso stretto del termi- 
ne, ne tanto meno può essere parago- 
nato a sistemi operativi come MS Win- 
dows e GNU/Linux, sia per quanto ri- 
guarda la complessità strutturale che le 
funzionalità disponibili. Proprio grazie 
alla sua compattezza, semplicità e di- 
sponibilità del codice (grazie alla licen- 
za Open Source) è possibile analizzare e 
modificare i sorgenti (Assembly, C e 
C++) per sperimentarne il funziona- 
mento e, magari, può essere utile come 
punto di partenza per la realizzazione 
di un nuovo sistema operativo per mac- 
chine con architettura x86 {http://aceos 
.netflrms.com). 



REQUISITI 
HARDWARE 
E SOFTWARE 

Il sistema operativo completo, in for- 
mato zip, occupa circa 230 KB di spazio 
e certamente per essere eseguito non 
necessita di configurazioni hardware 
esasperate, comunque il sistema mini- 
mo deve essere composto da una CPU 
486, 4 MB di RAM e supporto PCI 
{http:// aceos.netflrms.com/System.Re- 
quirement.html). Questo è quanto con- 
sigliato dall'autore, ma probabilmente 
pochi saranno interessati ad installare 
realmente il sistema; per questo, sia sul 
sito del progetto che nell'esempio 
seguente, eseguiremo Ace OS in emula- 
zione mediante il software Bochs. 
Quest'ultimo sarà indispensabile, suc- 
cessivamente, perché consentirà di ef- 



fettuare il debug del codice dopo aver 
apportato qualche modifica. Per quan- 
to riguarda i requisiti software, sono ne- 
cessari alcuni strumenti di sviluppo per 
compilare il sistema operativo, i cui sor- 
genti sono disponibili in formato 
Assembly, C e C++ (http:llaceos.net- 
firms.com/DevelopmentKits. html). 
All'indirizzo precedente è presente la 
lista completa dei programmi, per "for- 
tuna" non tutti necessari e comunque 
disponibili insieme al sistema operativo 
sul CD allegato alla rivista. 



ISTRUZIONI PER 
COMPILARE ACE OS 

Prima di procedere, bisogna instal- 
lare il compilatore MingGW ne- 
cessario per compilare i sorgenti 
C/C++, il compilatore NASM per i 
sorgenti in Assembly, un buon editor 
per programmatori (SciTe) e l'emula- 
tore Bochs. 

Per chi lo desidera, è possibile instal- 
lare alcuni IDE (Integrateci De- 
velopment Environment) o ambienti 
di sviluppo integrati che sem- 
plificano la gestione e la compilazio- 
ne del codice: DevC++ è un ambiente 
di programmazione avanzato per 
codice C/C++ dotato di interfaccia 
grafica e di tutte le funzionalità 
comuni agli strumenti di sviluppo 
più moderni; NasmIDE è un IDE a 
riga di comando per il compilatore 
NASM. Dopo aver estratto il conte- 
nuto del file AceOS_S2.0B.zip e instal- 
lato gli strumenti contenuti nel file 
tools.zip, copiamo la directory 
AceOS_S2.0B in un posizione qualsia- 
si e rinominiamola con il nome 
aceos. 

Eseguiamo una shell DOS (Start/Ese- 
guii Command.com) e spostiamoci 
nella directory aceos. Da qui digitia- 
mo il comando mingw32-make e pre- 
miamo Invio; questo compilerà tutti i 
sorgenti creando numerosi file ogget- 
to linkandoli tutti nel file Kernel.bin. 
Se la compilazione avviene con suc- 



cesso sulla console DOS dovrebbero 
apparire i messaggi seguenti: 

Id -Ttext 0x19000 -Tdata 0x258c0 - 
image 0x19000 --shared -entry 
KernelEntry -nostartupfiles -o 
Kernel.exe 

Kernel. o Processor.o Timer.o CTimer.o 
CKernel.o MemMan.o Heap.o 
DeviceDriver.o IO.o TMan.o 
TaskMan.o MemMove.o 

VGAText.o VGACursor.o Keyboard.o 
CKeyboard.o PIC.o PCI.o RTC.o GSH.o 
Harddisk.o HMess.o Printf.o 
Partition.o 

FAT.o Stringo Beep.o - 
LC:\MinGW\lib\gcc-lib\mingw32\3.2 
-LC:\MinGW\lib -Imingwex -Igcc 



Valicabili d'ambiente 



Variabili dell'utente per dornenico 



Variabile 
INCLUDE 


Valore 

C:\Prograrnmi\Microsoft Visual Studio .N... 


LIE 

TEMP 

TMP 


C:\Programmi\Microsoft Visual Studio .N... 
C:\Docurnents and 5ettings\domenico\I... 
C:\Document5 and 5ettings\domenico)I.,, 








1 Nuovo 1 | Modifica | Elimina 






at'ìabili di sistema 




Variabile 

NUMBER_OF_P... 
05 


Valore 

1 

Window5 NT 


I23!^^^^HH3 


PATHEXT 
PROCE550R A.. 


,C0M; .EXE; .BAT; .GMD; .VBS; .VBE; . JSj , , . . 
x86 








Nuovo j Modifica | Elimina 



Fig. 1: Finestra di dialogo per la gestione 
delle variabili d'ambiente. 



Prima di eseguire il comando mingw- 
32-make, verificate che la variabile di 
ambiente PATH contenga il percorso 
alle directory degli strumenti di svi- 
luppo, altrimenti bisogna aggiungerli. 
Per fare ciò in Windows XP basta sele- 
zionare dal Menu di avvio Start/Pan- 
nello di controllo/Sistema, da qui ba- 
sta selezionare la scheda Avanzate e 
successivamente il pulsante Variabili 
d'ambiente (Fig. 1). 
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CREAZIONE DEL 
FLOPPY DI BOOT 

Per creare il dischetto di avvio, spostia- 
moci nella directory Boot ed eseguiamo 
il comando make, dopo di che inseria- 
mo un floppy nel drive A ed eseguiamo 
il comando mkboot.bat. Questo servirà 
a creare il disco di boot per avviare il 
sistema operativo compilato in prece- 
denza. 



Il Bochs for Windows [FI 2 enables mouse] 







File Image Disk Options Help 


Q & Q & fc! % tf ^ S:= -? ^ E Label . | 


Narne Si;e Type 


Modified 


^1 Kernel., e ne 1,966 Application? 
JOSLoader.bin 3.275 File GIN 


Q2/1Q/2003 12:15:12 
02/11/2003 03:59:04 


H4QKB,1.452.Q32bjJtefree 2 Ite (5241 bytes] 


é 



Fig. 2: Creazione del file immagine con 
Winlmage. 

ACEOS 

ll\l EMULAZIONE 
coni BOCHS 

Per completare i passaggi successivi è 
necessario disporre del software di 
emulazione Bochs (fornito nel CD) e del 
programma Winlmage. Di quest'ultimo 
è possibile ottenerne un copia in prova 
(shareware) per 30 giorni scaricandola 
dall'indirizzo www.winimage. com. Av- 
viamo Winlmage e creiamo una nuova 
immagine selezionando File/New dal 
menù principale. Successivamente, 
premendo il tasto INS (oppure sele- 
zionando Image llnject), inseriamo i file 
Kernel.exe e OSLoader.bin (Fig. 2). 



ì 



il 



Initializing Timer :: Sucess 
Semi ine Intel CPU Family 5 Model 1 Steping 3. 
Jirtual Page Size = 4096. Physical Memory 8 MB RAM instai led. 
Real Time Clock Settings 11-11-3 
jlnitializing Keyboard :: Sucess 
Detecting PCI Devices : : device(s) foumd 

retecting ATA Devices : : 2 device(s) found 
Master Device < H0 ) :: Gemer ic 1Z34 - N/A 
Cylinders 40 Heads 16 Sectors 63. LBA Sectors 40320 



Device ( HI ) 



Generi e 1234 



LBA Sectors 20160 



Cylinders 20 Heads 16 Sectors 63. LBA Sectors 2016 
Initializing GFS :: Sucess 
Initializing IFS :: Sucess 

FAT1Z is found on H\0\O. Assigning drive letter C: 

FAT1Z is found on H\1\0. Assigning drive letter D: 
Initializing FAT File System :: Sucess 
File System(s) Kegistered :: 

FS Type [Il - Ilnstallable FS1 Total Uolumes 1 

FS Type [F] - IFAT File System] Total Uolumes 2 

success 

Loading CSliell.exe... : 

done 

CShell Uersion O.l 



Fig. 4: Ace OS in emulazione con Bochs. 

Selezioniamo Image/Boot Sector Proper- 
ties e, dalla finestra di dialogo che ap- 
pare, premiamo il pulsante Open, cari- 
chiamo il file Boot.bin dalla directory 
aceosIBoot e infine click sul tasto Save. 
A questo punto non ci resta che salvare 
l'immagine appena creata e avviare 
Bochs. Dalla schermata principale sele- 
zionare (2) Read options from... e indi- 
care il file di configurazione: è possibile 
inserire il nome del file bochsrc.txt op- 
pure premere semplicemente Invio. 
Alla schermata successiva basta sele- 
zionare (3) Edit options, in seguito (8) 
Disk options, scegliere (1) Floppy Disk 
e indicare il nome e il percorso comple- 
to del file immagine creato in preceden- 
za. I passaggi successivi servono per 
configurare il BIOS da utilizzare per il 
sistema e la scheda video, rispettiva- 



rm 



Bochs x86 Emulatoi 1 2.1.1 
February 08„ 2004 



tochs Conf igurat ion : Ma in Menu 



rhis is the Bochs Conf igurat ion Interface, ubere you can describe the 
machine that you uant to simulate. Bochs has already searched for a 
conf igurat ion file <typically called bochsrc.txt) and loaded it if it 
could be found. 1-Jhen you are satisfied uith the conf iguration, go 
a.head and start the simulation. 

i?ou can also start bochs uith the -q option to skip these mentis . 

L . Restore factory default conf iguration 

2. Read options from... 

3 . Edit options 

4. Saue options to... 

5 . Begin simulation 
». Quit non 

Please choose one : [2 ] _ 



mente BIOS-BOCHS-LATEST e VGA- 
BIOS-elpin-2.40 BIOS-BOCHS-LATEST. 
Per selezionarli bisogna tornare al pas- 
saggio precedente scegliendo l'opzione 
(zero) e in questa schermata basta 
scegliere (6) Memory options e successi- 
vamente indicare il percorso corretto 
dei due file posizionati nella directory 
di installazione di Bochs. 
A questo punto bisogna tornare indie- 
tro, fino alla schermata iniziale, utiliz- 
zando l'opzione (zero), salvare la con- 
figurazione con (4) Save options to... e 
successivamente avviare l'emulazione 
selezionando l'opzione (5) Begin Simu- 
lation. 

L'aspetto più interessante di Ace OS è la 
possibilità di studiare e modificare il co- 
dice sorgente e, grazie all'emulazione 
con Bochs, verificarne immediatamen- 
te i cambiamenti. Infatti, è possibile 
effettuate il debug del codice, avviando 
Bochs in modalità debug mediante la 
shell DOS con il comando bochsdbg. 
Prima di eseguire il comando è necessa- 
rio modificare la variabile d'ambiente 
PATH affinché contenga il percorso 
completo alla directory di installazione 
di Bochs. 



Ace OS 2.0 Beta 

Autore: samuelhard@yahoo.com 
Sul Web: http://aceos.netfirms.com/ 
Licenza: GNU GPL 
Nel CD: AceOS S2.0B.zip 



Fig. 3: Shermata iniziale di Bochs. 
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Bochs-2.1.1 

Emulatore di sistemi 
con architettura x86 

Bochs è un emulatore Open Source alta- 
mente portabile, per PC con architettura 
IA-32 (x86) scritto in C++, in grado di fun- 
zionare sulla maggior parte delle piattafor- 
me. Include l'emulazione delle CPU x86 
(Intel, AMD, Ciryx, etc), dei dispositivi di 
I/O più comuni, e dispone di un proprio 
BIOS. Attualmente, Bochs può essere 
compilato per emulare CPU 386, 486, Pen- 
tium, Pentium II e Pro, comprese le istru- 
zioni MMX , SSE, SSE2 e 3DNow (AMD). 
Bochs è capace di eseguire la maggior 
parte dei sistemi operativi all'interno del- 
l'emulatore: Linux, Windows 95, DOS e 
Windows NT 4. Bochs è stato scritto da 
Kevin Lawton ed attualmente è sviluppato 
dal team Bochs project ed è disponibile sul 
sito Internet "http://bochs.sourceforge.net". 
bochs-2.1.1. zip 

EasyPHP 1.7 

Applicazioni web con PHP e MySQL 

EasyPHP installa e configura automatica- 
mente un ambiente di sviluppo completo 
per la creazione di applicazioni web server 
side che interagiscono con i database, uti- 
lizzando il linguaggio di scripting PHP il 
server web Apache e il database server 
MySQL. Inoltre, include il programma 
phpMyAdmin, un'applicazione web based 
che semplifica notevolmente la gestione di 
database MySQL grazie ad un'interfaccia 
semplice ed intuitiva. La nuova versione 
1.7 include i seguenti software: Apache 
1.3.27, PHP 4.3.3, MySQL 4.0.15 e 
phpMyAdmin 2.5.3. 
easyphp1-7.zip 

Firebird 1.5 

Il database relazionale 
del nuovo millennio 

Il motore del database Firebird è stato 
creato da un team indipendente di svilup- 
patori volontari partendo dal codice sor- 
gente del database InterBase prodotto da 
Borland (allora Inprise) e distribuito con 
licenza IBL (InterBase Public License) il 25 
Luglio 2000. Firebird è un database relazio- 



nale (RDBMS) che supporta in modo qua- 
si completo lo standard ANSI SQL-92, ed è 
disponibile per sistemi GNU/Linux, 
Windows e può essere eseguito su una 
varietà di piattaforme UNIX. Inoltre, 
Firebird offre prestazioni elevate e pieno 
supporto per stored procedures e triggers. 
firebird-1.5.0.zip 

jEdit 4.1 

Editor Java multipiattaforma 

Realizzato completamente in Java, jEdit è 
un completo editor di testi per program- 
matori, disponibile per numerose piat- 
taforme tra cui MacOS X, OS/2, GNU/ 
Linux (Unix) e Windows. Il programma, per 
l'immediatezza e la semplicità di utilizzo, è 
molto usato per scopi didattici e da pro- 
grammatori non professionisti. jEdit inte- 
gra un completo linguaggio di macro e 
dispone di un'architettura facilmente 
estensibile mediante l'utilizzo di numerosi 
plughi facilmente gestibili tramite il "plu- 
ghi manager". 
jedit41.zip 

QCad 2.0.3.1 

Il disegno tecnico 2D diventa 
un gioco 

QCad è una potente applicazione CAD 
(Computer Aided Design) per la creazione 
di disegni tecnici 2D per costruzioni, inter- 
ni e addirittura parti meccaniche. Inoltre, 
riconosce i formati CAD più comuni come 
DFX (importazione ed esportazione), 
HPGL, DGN e EPS (solo importazione). 
qcad_2_0_3_1 .zipa 

TightVniC 1.2.9 

Controllo remoto mediante VNC 

VNC (abbreviazione di Virtual Network 
Computing) è un sistema client/ server che 
permette l'accesso remoto a desktop grafi- 
ci. Con VNC, è possibile accedere ad un 
sistema da qualunque altra macchina con- 
nessa ad Internet o in una rete locale . VNC 
è software libero (rilasciato sotto la GNU 
General Public License) ed è disponibile 
per numerose piattaforme tra cui Windows 
e GNU/Linux. TightVNC è una versione 
evoluta del VNC originale che include 



molte nuove caratteristiche, migliorie, otti- 
mizzazioni e correzioni di bug. Inoltre, può 
essere usato per l'amministrazione remota 
di Windows, Unix o ambienti di rete misti. 
tightvnc-1 .2. 9. zip 

Relo 0.9.9 

IDE per lo sviluppo 
di applicazioni C/C++ 

Ambiente di sviluppo integrato (IDE) per 
creare applicazioni Windows in linguaggio 
C/C++. Il software distribuito con licenza 
Open Source (GNU GPL) è disponibile sot- 
toforma di sorgenti o eseguibile per piat- 
taforma Windows. Relo utilizza i compila- 
tori MingW32 (la versione per Windows del 
celebre compilatore GCC - GNU Compiler 
Collection) e Borland C++. L'ambiente di 
sviluppo è intuitivo, leggero e altamente 
personalizzabile. Inoltre, consente di crea- 
re codice per oltre 19 linguaggi di program- 
mazione con funzioni di syntax highligh- 
ting, e dispone di strumenti per importare 
progetti da altri ambienti di sviluppo come 
Visual C++, Borland C++ Builder, Dev C++ 
e Delphi. 
relosetup099.zip 

Zope 2.7 

Application server professionale 

Zope è una piattaforma che permette a svi- 
luppatori con differenti livelli di compe- 
tenza di costruire applicazioni web ad alto 
contenuto: ogni collaboratore ha a disposi- 
zione gli strumenti per creare e gestire per- 
sonalmente il sito, scrivendo articoli, pro- 
ponendo news, documentazione, etc. In 
termini tecnici Zope è un framework, 
costituito da moduli che interagiscono tra 
di loro per fornire numerosi servizi: server 
web, database ad oggetti, una completa 
interfaccia di amministrazione, interazio- 
ne con database relazionali e supporto per 
numerosi linguaggi di scripting. Il linguag- 
gio nativo di Zope è Python, ma è possibile 
utilizzare anche Perl. Zope è distribuito 
con licenza Open Source ZPL (Zope Public 
License). I termini della licenza ZPL con- 
sentono di ottenere e modificare codice 
sorgente. 
zope-2.7.0.zip 
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AppForge Crossfire 

Sviluppo Mobile con VB 6 e VB.NET 

Con Crossfire, puoi riversare tutta l'espe- 
rienza maturata lavorando con VB 6 o con 
VB.NET nello sviluppo di applicazioni per 
dispositivi mobili. Crossfire si integra per- 
fettamente sia nell'IDE di Visual Studio 
.NET che in quello di Visual Basic 6.0, con- 
sentendo di sviluppare in pochissimo 
tempo applicazioni che girano sulla mag- 
gioranza dei dispositivi mobili esistenti: 
alm OS, Pocket PC 2000/2002, Windows 
Mobile 2003, Nokia Series 60, e Symbian 
UIQ. Sviluppando applicazioni con Cros- 
sfire potremo approfittare di numerose 
agevolazioni, a partire dalla dimensione 
delle form già settata per lo specifico 
dispositivo su cui vogliamo distribuire 
l'applicazione. Nella toolbar avremo a di- 
sposizione dei nuovi controlli appositi per 
applicazioni Mobile ed un nuovo menu 
con decine di nuove funzionalità. Per regi- 
strarsi occorre seguire il link: http://scripts 
.appforge .com levals Iafevals.aspx?p=AFCF 
e ciccare sul tasto "Request evaluation key 
only". 
Crossfire 5.0.1. exe 

FLASH MX 2004 

In italiano, la versione completa del 
più celebre applicativo per la crea- 
zione di progetti multimediali 

Due versioni, una dedicata ai designer 
(Flash MX 2004) ed una pensata per i deve- 
loper (Flash MX 2004 Professional). Questa 
scelta di realizzare due pacchetti distinti 
testimonia la divisione di ruoli che la 
Macromedia ha individuato nell'utilizzo 
della tecnologia alla base di Flash, e che 
possiamo definire l'evoluzione naturale di 
una strategia di cui si potevano cogliere i 
primi segnali a partire dalla versione MX 
Forte integrazione con XML, utile sia nella 
manipolazione dei dati che nella gestione 
dei componenti. La versione Professional 
possiede tutte le caratteristiche della ver- 
sione normale con in più dei componenti 
aggiuntivi creati per agevolare lo scambio 
di dati e numerose opzioni, molte delle 
quali pensate per dialogare con program- 
mi di terze parti. 
FlashMX2004-it.zip 

SourceCode to 
Flowchart 2.43 

Analizza il tuo codice sorgente 
attraverso flowchart 

Avete mai provato a sviluppare un'applica- 



zione dopo un mese (o un anno) di pausa? 
Se la risposta è affermativa, avrete proba- 
bilmente provato una forma di disorienta- 
mento simile a quella che si prova metten- 
do mano al codice di un'applicazione svi- 
luppata da altri. In entrambi i casi, ci sarà 
utilissima l'utility che presentiamo: a parti- 
re dal codice, SourceCode to Flowchart 
genera un diagramma di flusso che con- 
sente di capire esattamente il percorso 
seguito all'interno dell'applicazione. Buo- 
na l'interfaccia, mentre risulta eccellente 
l'ampiezza dei linguaggi supportati: C, 
C++, VC++(Visual C++ .NET), VB(Visual 
Basic), VBA, Qbasic (quickbasic), VB- 
Script(VBS), ASP Visual C#, Visual Basic 
.NET.Visual J# .NET, VC++.NET, ASENET, 
Java, JSP JavaScript, Delphi(Object Pascal), 
PowerBuilder, PHP Visual FoxPro e Perl. 
Versione di valutazione: risulta limitato il 
livello di analisi consentito. 
s2f243.zip 

XMLSpy Home 
Edittali 2004r4 

Scegli lo sviluppo XML che fa per te 

Questo mese, ioProgrammo vi offre due 
versione di XMLSpy: la Home la Enterprise. 
La Home edition è gratuita e si presenta 
come un tool entry level per lo sviluppo di 
documenti XML. Ideale per hobbisti e stu- 
denti, rappresenta uno dei punti di riferi- 
mento per gli sviluppatori "casalinghi". 
XMLSPY Enterprise Edition è tra i migliori 
tool disponibili: agevola la costruzione di 
applicazioni XML-based, siti Web, Web 
Services e tutto quanto ruota attorno 
all'XML, la stella incontrastata dell'attuale 
panorama della programmazione. Alla fine 
dell'installazione è possibile scaricare 
automaticamente dei alcuni tool aggiunti- 
vi. Al primo avvio ci viene richiesto il 
nostro nome e un indirizzo mail cui verrà 
spedita in pochi, istanti, la chiave di attiva- 
zione necessaria ad attivare il software per 
trenta giorni. 

XMLSPYHomeComplete2004.exe 
XMLSPYEntComplete2004.exe 

Manforte Enterprise 
Edition 2004r4 

Potente tool per l'integrazione 
di dati 

Una volta "disegnato" lo schema di trasfor- 
mazione che vogliamo realizzarem Map- 
force si fa carico di generare il codice (Java, 
C++, C# o XSLT) necessario a completare 
l'opera. Le trasformazioni supportate sono 



XML-to-XML e Database-to-XML: rispar- 
mio di tempo e garanzia dei risultati sono i 
principali vantaggi di una soluzione di que- 
sto tipo. Attraverso Mapforce 2004 è possi- 
bile caricare direttamente le tabelle del da- 
tabase e gli schemi XML, per poi disegnare 
visualmente la mappa che trasforma le 
tabelle in un qualsiasi modello di dati 
espresso nell'XML Schema. Fatto questo, 
Mapforce 2004 genera automaticamente il 
codice applicativo necessario ad effettuare 
la conversione dal database indicato verso 
l'XML. Il codice così ottenuto è completa- 
mente customizzabile e supporta tutti i più 
diffusi database: SQL Server, Oracle9i e 
qualsiasi database per cui sia disponibile 
un driver ODBC. Versione di valutazione 
valida trenta giorni. 
MapForceEntComplete2004.exe 

Java 2 SDK, Standard 
Edition 1.4.2 

Tutto quello che serve per realizzare 
applicazioni Java 

L'ambiente di sviluppo Sun che negli ultimi 
anni si è imposto come la prima scelta per i 
programmatori che lavorano in ambito 
multipiattaforma. In questa versione, 
nuove funzionalità e migliori prestazioni 
arricchiscono l'ambiente. Rich client appli- 
cation e Web Services sono i campi in cui 
sono più evidenti i miglioramenti. Tra i 
miglioramenti che più faranno gola agli svi- 
luppatori ci sono sicuramente quelli ine- 
renti Swing. Davvero ghiotti i due nuovi 
look&feel: GTK+ e, finalmente, Windows XP 
Anche le applicazioni Java possono così 
integrarsi pienamente nell'ambiente visua- 
le del più recente Windows. Anche GTK+ 
risulta molto interessante: attraverso un 
semplice resource file, è possibile settare i 
parametri fondamentali del look&feel. 
Sempre in ambito Swing, è da notare la 
pesante cura dimagrante cui è stata sotto- 
posta JFileChooser, che risulta essere molto 
più veloce della precedente versione, in 
alcuni casi anche 300 volte più veloce! 
j2sdk-1_4_2_04-windows-i586-p.exe 

lnstaller2Go 4.0.3 

Un sistema facile e gratuito per 
realizzare pacchetti di installazione 

Un tool per la creazione di file autoinstal- 
lanti che non impegna lo sviluppatore nel 
dover imparare l'ennesimo linguaggio di 
scripting: con una interfaccia che punta 
tutto sul frag&drop, realizzare pacchetti di 
installazione diventa un vero gioco da 
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ragazzi. Benché gratuito, Installer2Go va 
incontro a tutte linee guida per la certifica- 
zione WindowsXE Versione dimostrativa: 
alla fine di ogni istallazione si è rimandati 
ad una pagina pubblicitaria che fa riferi- 
mento al produttore di Installer2Go. 
i2g.exe 

Astrum 
InstalIWizarcI 2.02.7 

Crea il tuo setup 

Astrum InstallWizard è un versatile 
software per la creazione di pacchetti di 
installazione. Potente e ben ideato, con- 
sente di arrivare al pacchetto di installa- 
zione completo attraverso una semplice e 
chiara procedura guidata. L'ottimo help ed 
i numerosi tutorial aiutano anche i meno 
esperti a realizzare in pochi istanti pac- 
chetti di livello professionale. Non rinun- 
cia alla completezza comprendendo il 
supporto per file JPEG ed MP3. E' possibi- 
le utilizzare variabili utente, dividere I file 
di installazione su più dischi e interagire in 
vario modo con il registro di Windows. 
Semplice ed altamente personalizzabile. 
Da rimarcare la presenza di un apposito 
Wizard per la creazione di update. 
Versione dimostrativa, inibita la possibilità 
di creare distribuzioni. 



XStudio - Standard 
Edition 2.5 

Semplifica la scrittura di codice XSL 

Un grande ausilio alla produzione di do- 
cumenti XSL: attraverso l'ampio uso del 
drag& drop, XStudio mette anche i meno 
esperti nelle condizioni di poter generare 
trasformazioni da XML a HTML e da XML 
a XML. L'interfaccia visuale non richiede 
alcuna conoscenza di XSL. Versione di 
valutazione valida trenta giorni. 
XStudio.zip 

SheerPower 4GL 3.5 

Crea applicazioni per Windows in 
un batter d'occhio! 

Il linguaggio adottato da SheerPower 4GL è 
particolarmente semplice da utilizzare e 
mutua dai linguaggi di scripting la loro 
estrema immediatezza. Per quanto legge- 
ro, FIDE si presenta completo e disponibi- 
le allo sviluppo di applicazioni di qualsiasi 
dimensione. Oltre ad un motore di databa- 
se integrato, SheerPower offre anche l'indi- 
spensabile supporto per ODBC. Anche le 
funzioni di accesso ad Internet risultano 



particolarmente curate. Gratuito. 
sp_install.exe 

Code Co-op 4.1 

Funziona in modalità distribuita 
senza la necessità di utilizzare un 
server! 

Code Co-op 4.0 è un programma di con- 
trollo versioni sorgenti per applicazioni 
realizzate in C++, Java, HTML... Può fun- 
zionare in modalità distribuita senza la 
necessità di utilizzare un server. Supporta 
non solo la collaborazione tramite Lan, 
ma anche via e-mail. In tal modo, è possi- 
bile collaborare ad un progetto pur non 
risiedendo nella stessa area geografica e, 
soprattutto, senza la necessità di installare 
un server! Grazie all'uso di appropriati 
messaggi di posta elettronica, è possibile 
ottenere la sincronizzazione dei sorgenti 
persino tra postazioni che non sono 
costantemente connesse in rete. Si integra 
con strumenti di sviluppo quali Microsoft 
Visual Studio .NET, Borland Delphi, C++ 
Builder ed altre applicazioni che utilizza- 
no le API SCC della Microsoft. Versione di 
valutazione valida trentuno giorni. Per 
scegliere di utilizzare la versione trial, 
basta cliccare su "Keep evaluating" e verrà 
visualizzata la finestra principale. 
co-op.exe 

ShareGuard Copy 
Protection 2.1 

Aumenta la protezione del tuo 
software 

Un tool per proteggere le versioni sharewa- 
re delle applicazioni che distribuiamo, ren- 
dendo inutili le copie non licenziate. 
Potremo realizzare e distribuire versioni 
shareware delle nostre applicazioni, deci- 
dendo la durata del periodo di prova dopo 
il quale l'applicazione diventerà inservibi- 
le. Funziona su piattaforma Windows e con 
qualsiasi ambiente di programmazione 
(Visual Basic, MS Access, C++, Delphi, 
VB.NET, C#). Versione dimostrativa 
(Ovviamente, visto il genere!) valida trenta 
giorni e limitata a cinquanta utilizzi. 
ZSSHGD.zip 

CodeLogic 1.5 

Non solo UML 

CodeLogic fornisce una dettagliata analisi 
di qualsiasi progetto Java, generando dia- 
grammi UML (di classe e sequence) relati- 
vi alle classi e ai metodi selezionati. Uno 
degli aspetti più interessanti è la possibi- 



lità di visualizzare codice attraverso una 
particolare interfaccia grafica che, a fianco 
di ogni riga, riporta un simbolo che ne 
semplifica la comprensione. Questa visua- 
lizzazione si può considerare come diretta 
conseguenza dei digrammi sequence e 
agevola notevolemente la lettura del codi- 
ce. Impagabile nel caso in cui vi troviate a 
studiare codice prodotto da altri. Versione 
di valutazione valida quindici giorni e 
limitata ad un utilizzo continuo di massi- 
mo dieci minuti. 
codelogic setupWin.exe 

Serial Basic 2.2 

Tutta la libertà di programmare la 
porta seriale 

Un emulatore di terminale che consente 
di programmare la porta seriale tramite 
script, in un linguaggio che ha tutti i 
costrutti fondamentali del basic, inclusa la 
sua proverbiale semplicità. Attraverso sin- 
gole istruzioni, è possibile inviare coman- 
di a dispositivi collegati alla seriale e, attra- 
verso una semplice istruzione di assegna- 
mento, è possibile immagazzinare il valore 
ritornato dal dispositivo in una variabile. 
Strutture decisionali, cicli e la possibilità di 
accedere al disco, definiscono la comple- 
tezza dell'ambiente. L'utilizzo dell'appli- 
cazione è gratuito per trentuno giorni e 
per un massimo di cinquanta volte. 
SerialBasic2_2.exe 

SoftwareKey Trial 
Creator 1.10 

Per creare versioni di prova del pro- 
prio software 

Davvero semplice e ben fatto questo pic- 
colo tool che consente di trasformare 
qualsiasi applicazioni Win32 in versione 
trial-30 giorni. Attraverso una procedura 
wizard, siamo guidati nelle varie scelte 
necessarie alla definizione del pacchetto 
di installazione. Gratuito. 
TrialCreatorSetup.exe 

AppMind 3.5.1 

Migliora la qualità delle applicazioni 
in C e C++ 

Una soluzione completa per il controllo 
della qualità di applicazioni scritte in C e 
C++. Un insieme di tool che consente di 
migliorare al contempo prestazioni e 
robustezza attraverso tre fasi fondamenta- 
li: test, debug e timing delle performance. 
Gratuito. 
apm Win32 040506 0351BL777.exe 
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Come integrare nelle pagine Web una voce che guida l'utente 

La pagina web "parla" 

Da qualche tempo, un nuovo fenomeno ha timidamente iniziato 
a diffondersi online. Siti web che comunicano con i propri visitatori 
attraverso commenti vocali. 



Non si tratta dei soliti screen reader, ma di veri 
e propri messaggi parlati pensati per sem- 
plificare la fruizione delle pagine e spesso 
associati a effetti visivi. Riflettendo sulla questione, 
potremmo chiederci come mai alcune web agency 
scelgano di dotare di audio le pagine di un sito, visto 
che gli screen leader sono completamente automa- 
tici. Per chi non ne avesse mai sentito parlare, gli 
screen reader - nati per venire incontro alle esigenze 
dei navigatori non vedenti, sono software in grado di 
leggere le pagine web create rispettando i parametri 
del W3C sull'usabilità. Nonostante la validità degli 
intenti, allo stato attuale diversi limiti tecnici rendo- 
no poco fluida la "lettura artificiale" del sito da parte 
dello screen leader. Pensiamo solo alla lingua: se il 
programma è ottimizzato per leggere l'inglese, diffi- 
cilmente garantirà la corretta pronuncia di un testo 
in italiano. Inoltre, lo screen reader non riesce a dare 
la giusta enfasi alle parole: una stessa frase, pronun- 
ciata con un tono differente, può assumere diversi 
significati. L'alternativa è quindi creare commenti 
sonori letti da un bravo "speaker" e farli ascoltare al 
navigatore durante la connessione al sito. Il file 
index.htm presente nella cartella esempio_comple- 
to (disponibile nel CD-ROM allegato alla rivista) 
chiarisce quanto stiamo dicendo. 



IL MOSTRO 
ESPERIMENTO 



La pagina principale del sito web http://www.iopw 



grammo.it è stata associata ad una presentazione 
audio costituita da voci che leggono alcune didasa- 
calie per descrivere le varie sezioni del sito dedicato 
alla rivista di programmazione più venduta in Italia. 
Le voci sono state registrate e convertite in file MP3, 
che vengono eseguiti secondo un ordine prestabili- 
to. Il progetto è strutturato in modo da rendere facil- 
mente aggiornabili i file audio e il loro ordine di ese- 
cuzione. 

È importante sottolineare che non si tratta di una 
pagina diversa realizzata per l'occasione: è la home 
page disponibile online, a cui sono state apportate 
alcune piccole modifiche. 

Quindi è lecito chiedersi: dov'è il trucco? Come 
vedremo tra breve, per ottenere questo risultato 
bastano un filmato Flash grande un pixel, un file 
XML dalla struttura molto semplice e qualche picco- 
lo ritocco al file HTML. 



METTIAMOCI 
ALL'OPERA 

Prima di tutto, dobbiamo creare una sequenza di 
brevi messaggi vocali in formato MP3 e collocarli 
nella stessa cartella in cui si trova il file HTML a cui 
vogliamo associare l'audio. Sarebbe opportuno regi- 
strare i messaggi con una tonalità chiara e priva di 
inflessioni: se non vi sentite a vostro agio davanti a 
un microfono, potete coinvolgere un amico o un 
collaboratore che possa registrare i messaggi in 
modo adeguato. L'ideale sarebbe qualcuno che lavo 
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Fig. 1: La prima pagina di ioPtogrammo nella versione "audio", con didascaiie interattive che guidano l'utente 
durante la navigazione. 
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Fin dalla versione 5, 

Flash è in grado di 

leggere documenti 

XML (Extensible 

Markup Language). I 

documenti XML si 

possono importare in 

Flash a patto di essere 

well formed, cioè "ben 

formati": questo 

significa che anche 

quando non fanno 

riferimento a 

specifiche DTD, 

devono rispettare tutti 

gli standard previsti. 

Allo stato attuale 

Flash non crea 

autonomamente i file 

XML, ma può solo 

leggerli. Ricorrere a 

file di questo tipo può 

costituire un metodo 

semplice e immediato 

per acquisire dati posti 

all'esterno di un 

filmato Flash. In altri 

termini, pur essendo a 

tutti gli effetti 

semplici file di testo, i 

file XML consentono 

di simulare una 

semplice base di dati 

grazie alle possibilità 

fornite dai vari nodi (i 

tag che li 

contraddistinguno). 



ri in radio, faccia teatro o, in generale, sia abituato ad 
usare la propria voce in ambito professionale. 
Nell'esempio sul CD-ROM i file da eseguire in 
sequenza sono otto: benvenuto l.mp3, primo.mp3, 
secondo.mp3, terzo.mp3, quarto.mp3, quinto.mp3, 
sesto.mp3 e settimo.mp3. Per essere precisi a questi 
andrebbe aggiunto anche bentornato.mp3, ma poi- 
ché costituisce un'eccezione, ne parleremo alla fine 
di questo articolo. 



IL RUOLO DI XML 

Gli otto file saranno caricati ed eseguiti in sequenza 
da un filmato Flash, nascosto nella pagina HTML. 
Flash, oltre a eseguire i file audio importati, può 
anche caricare uno alla volta in sequenza gli MP3 
esterni. Il filmato che useremo contiene uno script 
che precarica ed esegue vari file audio seguendo un 
certo ordine. Tuttavia, se decidessimo di cambiare i 
nomi dei file, il loro numero o l'ordine di esecuzione, 
non saremmo costretti a modificare sorgente FLA, 
poiché il filmato lavora in squadra con un file XML 
collocato nella stessa cartella. 
Il file XML fornisce a Flash le seguenti informazioni: 

• Il numero dei file MP3 da eseguire. 

• L'ordine in cui devono essere eseguiti. 

• I nomi dei file MP3. 

Proprio questa caratteristica consente di aggiornare 
con facilità il nostro meccanismo, modificando solo 
i tag del file XML, senza dover intervenire continua- 
mente sul filmato Flash. Di conseguenza, per riuti- 
lizzare il materiale disponibile sul CD-ROM della 
rivista, è sufficiente intervenire sul file XML e sosti- 
tuire i vari file MP3 con i propri. 
Dopo avere descritto a grandi linee il funzionamen- 
to, passiamo alla pratica. Nella stessa cartella che 
contiene l'esempio completo è disponibile anche la 
cartella tutorial. Al suo interno troviamo altre tre sot- 
tocartelle: paginajweb, sorgentijlash e MP3. 

• La cartella pagina_web contiene una versione 
ridotta della pagina principale del sito di ioPro- 
grammo. 

• La cartella sorgentijlash contiene file esem- 
piojbase.fla, il motore del nostro progetto. 

• La cartella MP3, infine, contiene tutti i file audio 
necessari per la nostra sequenza. 

Per associare l'audio alla prima pagina di iopro- 
grammo.it, prima di tutto salviamo la cartella pagi- 
na web sul nostro hard disk. Preleviamo i file audio 



presentì nella cartella MP3 e collochiamoli nella car- 
tella paginajjoeb. Analogo discorso vale per esem- 
piobase.fla presente nella cartella sorgentijlash: 
anche questo file dovrà essere posto nella cartella 
pagina_web. 

Apriamo un editor di testo e scriviamo il seguente 
file XML: 

<?xml version = "1.0"?> 

<brani> 

<voce>benvenutol.mp3</voce> 

<voce> primo. mp3</voce> 

<voce>secondo.mp3</voce> 

<voce>terzo.mp3</voce> 

<voce>quarto.mp3</voce> 

<voce>quinto.mp3</voce> 

<voce>sesto.mp3</voce> 

<voce>settimo.mp3</voce> 

</brani> 

Chiamiamolo listafile e salviamolo con estensione 
.xml nella cartella paginajjoeb, scegliendo come ti- 
po semplice testo. Analizziamo in breve la struttu- 
ra di questo semplicissimo file: è privo di riferimen- 
ti alla DTD e caratterizzato da un nodo principale 
costituito dall'elemento <branixlbrani>. Il nodo 
principale prevede un certo numero di nodi figli (i 
tag <vocex/voce>) che a loro volta contengono 
ognuno il nome di un file MP3. 
Il contenuto dei vari tag viene definito anche nodo 
di testo e rappresenta uno dei due modi in cui pos- 
siamo inserire informazioni valide per Flash in un 
file XML; l'altro procedimento prevede l'uso degli 
attributi, cioè di coppie nome="valore" da inserire 
all'interno dei vari tag. 

Nel nostro esempio, Flash legge i nodi di testo costi- 
tuiti dai nomi dei file MP3, acquisendo tutte le infor- 
mazioni che gli sono necessarie. Grazie ai tag XML, 
nel file Flash, per esempio, non sarà necessario spe- 
cificare il numero di file da ascoltare. 
Per adesso, adoperiamo questo tipo di struttura: 
successivamente modificheremo il file XML per au- 
mentare il numero di dati da passare a Flash. 



IL "FILMATO" FLASH 

Apriamo il file esempiobase.fla con Flash MX 2004: 
per prima cosa notiamo che manca lo stage. Chi non 
ha mai adoperato Flash probabilmente non sa che al 
centro dell'interfaccia si trova un'area di lavoro (lo 
stage) rappresentata da un foglio bianco largo 550 e 
alto 400 pixel. Aprendo la finestra Proprietà del 
documento da Elabora > Documento (oppure con 
CTR+J), notiamo che la larghezza e l'altezza del do- 
cumento sono state fissate a un pixel nei rispettivi 
campi di regolazione. Infatti, nel nostro progetto, 
non sono richieste le peculiarità grafiche di Flash, 
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ma la sua capacità di gestire l'audio. Quindi possia- 
mo lavorare con un file Flash privo di contenuti gra- 
fici. Il codice si trova tutto nel primo fotogramma 
della Linea temporale. Per visualizzarlo, ricorriamo 
al percorso Finestra > Pannelli di sviluppo > Azioni 
(o, in alternativa premiamo il tasto F9). Tra breve 
analizzeremo il codice, ma per il momento occupia- 
moci di inserire il file Flash all'interno della home 
page di ioProgrammo. 



Proprietà documento 



lpx] 



(larghezza) x \ 1 px 



(altezza) 



Adatta: I stampante I I Contenuto I Predefinito 
Colore sfondo: I 1 



Frequenza 



fotogrammi: 12 
Unità di misura 



f/s 



righello: 



Pixel 



Impostazione predefinita 



Annulla 



Fig. 2: La finestra proprietà del documento consente 
di regolare le principali impostazioni del file Flash. 



Pubblichiamo il file, seguendo il percorso File > Pub- 
blica (oppure premendo il tasto F12): nella stessa 
posizione in cui si trova il sorgente esempiobase.fla 
vengono creati anche i file esempiobase.html ed 
esempiobase.swf. Lanciando il file esempiobase.html, 
potremo già ascoltare le varie voci riprodotte in 
sequenza: il filmato SWF carica il file XML, che a sua 
volta indica il nome dei file MP3 da caricare. 
A questo punto possiamo inserire il riferimento al 
filmato nella pagina di ioProgrammo. Apriamo 
esempiobase.html con un qualsiasi programma di 
videoscrittura e copiamo l'elemento <object></ob- 
ject> con tutto il suo contenuto. Apriamo con un 
programma di videoscrittura il file index.htm, che 
contiene la versione sintetica della prima pagina del 
sito di ioProgrammo, e incolliamo l'elemento 
<object></object> prima del tag <lbody>. 
Con queste operazioni abbiamo collocato il file surf, 
che misura 1 pixel x 1 pixel, alla fine della pagina 
index.htm, senza correre il rischio di scompaginare 
(anche in modo impercettibile) il layout. Quando la 
pagina HTML si apre nella finestra del browser, 
viene riprodotta una sequenza di voci. Come accen- 
nato in precedenza, possiamo sostituire i commenti 
vocali inserendo il nome di altri file MP3 nel file 
XML, oppure aggiungere un file audio in più scri- 
vendo un altro nodo <voce><lvoce>. 



var archivio:XML= new XML; 
archivio.ignoreWhite=true; 
archivio.onLoad=function():Void{ 
var elenco:Array = new Array(); 
for(var a:Number = 0; a < 

this.firstChild.childNodes.length; ++a){ 
elenco[a]= this.firstChild.childNodes[a] 

.firstChild.nodeValue; 

_J 

// codice relativo al suono 

} 

archi vio.load("listafile. xml"); 

Flash crea un nuovo oggetto XML denominato ar- 
chivio. La proprietà ignoreWhite accetta solo valori 
di tipo booleano e per impostazione predefinita ha 
come valore false. 

Attribuendo a questa proprietà il valore true, si fa in 
modo che gli spazi vuoti siano ignorati e si evita di 
considerare come nodi di testo anche le semplici 
tabulazioni. Attraverso il gestore di eventi onLoad 
vengono eseguite una serie di istruzioni in seguito al 
caricamento del file XML e alla successiva analisi 
dello stesso file nell'oggetto archivio. Prima di pro- 
cedere oltre, riepiloghiamo in breve alcune delle 
proprietà che consentono a Flash di analizzare un 
file XML. 

• firstChild consente di individuare il nodo prin- 
cipale di un file XML. Scrivendo nomeoggetto 
.firstChild, oppure con la sintassi relativa this. 
fisrtChild, possiamo accedere al nodo principale 
(che nell'esempio è <brani>). 

• chlidNodes [i] individua i vari nodi figli che com- 
pongono il file XML, attraverso una struttura si- 
mile a quella degli Array. 

• NodeValue restituisce il valore di un nodo di te- 
sto. 

Grazie a queste proprietà, adoperando la sintassi del 
punto, possiamo leggere tutte le informazioni di un 
file XML. Per esempio scrivere this.firstChild.child 
Nodes.length; ci permette di sapere quanti nodi figli 
ci sono all'interno del documento. 
Su questa base possiamo comprendere meglio la 
finalità del ciclo for che, dopo avere contato tutti i 
nodi del documento XML, passa all'array elenco 
tutti i nodi di testo. Di conseguenza: 




UNO SGUARDO 
AL CODICE 

Riapriamo il file Flash e osserviamo il codice Action- 
Script 2.0. Tutto il meccanismo dello script si basa 
sul caricamento del file XML: 



scrivere this.firstChild.childNodesfO]. firstChild. 
nodeValue equivale a scrivere benvenuto l.mp3; 

scrivere this.firstChild.childNodes[l]. firstChild. 
nodeValue equivale a scrivere primo.mp3; 

scrivere this.firstChild.childNodes [2]. firstChild. 
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nodeValue equivale a scrivere secondo.mp3; 
e così via 

Il nostro obiettivo è quello creare un Array elenco, in 
cui si trovino tutti i file MP3. Per individuare i file da 
caricare ed eseguire, ActionScript farà riferimento a 
questo specifico Array. 



.. index. htm - Blocco note 



, D X 



r?c:dife' : : ^::=r Visualizza ? 



<!— tag filmato Flash --> @ 

<object classid="clsid:d27cdb6e-ae6d-llcf-96bB-444553540000" 
codebase="http://fpdo wnload.macromedia.com/pub/shockwave/ca 
bs/flash/swflash,cab#version=7 J 0/ù,0" width="l" height="l" 
id="audio" align="middle"> 

<param narrie-"allowScriptAccess" value="sameDomain" /> 
<param name="movie" value="audio.swf" /> 
<param name="quality" value="high" /> 
sparami name-"bgcolor" value-"#ffffff /> 

<embed src-"audio.swf quality— "high" bgcolor-"#ffffff width-"l" 
height="l" name="audio" align="middle" 
allowScriptAccess="sameDomain" 
type="application/x-shockwave-flash" 

pluginspage="http://w ww.macromedia.com/go/getflashplayer" /> 
</object> 

<!— fine tag filmato Flash — > 
c/BODY>c/HTML> 



Fig. 3: Nel pannello Azioni visualizziamo il codice rela- 
tivo alla gestione dei file MP3. 



Nell'ultima riga di codice, il metodo IoadQ specifica 
quale file XML deve essere caricato. Anche se può 
sembrare una contraddizione, per assicurare il cor- 
retto funzionamento del codice è importante utiliz- 
zare il metodo IoadQ solo dopo avere specificato le 
istruzioni del gestore onLoadQ. In questo modo si dà 
il tempo al Flash Player di acquisire le operazioni da 
compiere nel momento in cui il file XML è stato cari- 
cato. Del resto, considerando che il nostro file XML 
pesa un solo Kb, possiamo facilmente immaginare 
con quale velocità Flash carichi il file. 




file di esempio disponibili sul CD hanno una valenza puramente 
didattica, per cui la loro dimensione (in alcuni casi eccessiva) non deve 
essere presa come punto di riferimento: quando si preparano i messaggi 
parlati, bisogna evitare che uno o più MP3 abbiano una durata (e quindi 
un numero di Kb) superiori al messaggio iniziale. Questo squilibrio 
potrebbe creare rallentamenti al momento dell'accesso alla pagina web, 
in presenza di una connessione lenta. L'ideale sarebbe creare un file 
iniziale un po' più grande, con tutti gli altri più piccoli e possibilmente 
accomunati da una dimensione simile. Con questo sistema, eseguito il 
primo, gli altri hanno il tempo di essere caricati e, possedendo dimensioni 
simili, non causano intervalli troppo lunghi tra un'esecuzione e l'altra. 



SCEGLIERE IL RITMO 

Il codice descritto finora riguarda solo l'interazione 
con il file XML. Abbiamo tralasciato al codice relati- 
vo alla gestione del suono che si trova prima dell'ul- 
tima parentesi graffa. Aprendo il file Flash notiamo 
un ulteriore blocco di codice di codice, inserito al 
posto del commento riportato nello script prece- 
dente. Prima di soffermarci sul funzionamento di 



queste righe di codice, chiariamo quali sono le no- 
stre esigenze. Ci sono un paio di importanti aspetti 
tecnici con cui fare i conti. 

1 . Non è opportuno caricare tutti insieme i file MP3 
prima di eseguirli, perché si rischia di produrre 
notevoli tempi di attesa dovuti al caricamento 
che precede l'esecuzione dei messaggi. 

2. Non conviene caricare ed eseguire i file MP3 uno 
alla volta: i navigatori dotati di connessioni lente 
potrebbero riscontrare fastidiose pause tra un 
messaggio vocale e l'altro. 

L'unica possibilità per ottimizzare i tempi, è fare in 
modo che non appena un file viene caricato inizi su- 
bito il caricamento del file successivo. Allo stesso 
tempo, bisogna controllare ad ogni istante, quali file 
sono stati caricati in modo da eseguirli appena 
pronti. Questo meccanismo ci consente di eseguire i 
suoni mentre altri vengono contemporaneamente 
caricati - una soluzione inusuale rispetto alla "classi- 
ca" procedura di caricamento dei suoni esterni. 
Lo script per caricare un file MP3 in genere ha una 
sintassi del tipo: 

var miosuono:Sound = new Sound(); 
miosuono.onLoad = function (caricatoiBoolean) 

{ 

if( caricato) 

_J 

miosuono.start(); 

_J 

} 

miosuono.loadSound("primo.mp3", false); 

In breve, viene creato un nuovo oggetto Sound chia- 
mato miosuono e, quando Flash tenta di caricare 
suono con il gestore di evento onLoad, viene accer- 
tato il valore true della variabile caricato, che è tale 
solo se il file è stato importato correttamente. 
Il metodo startQ, in grado di attivare il suono, entra 
in azione solo se la condizione caricato è soddisfat- 
ta. Nell'ultima riga di codice, come nel caso del file 
XML, si ricorre al metodo IoadSoundO per caricare 
file. Il metodo in questione prevede due parametri: il 
primo specifica il nome ed il percorso del file MP3, 
secondo il tipo di caricamento, che prevede solo due 
valori, true (in streaming) e false (senza streaming). 
Se vogliamo evitare interruzioni durante l'esecuzio- 
ne del suono, dobbiamo inserire false come secondo 
parametro. Se inserissimo questo script all'interno 
di un fotogramma chiave in un file Flash e pubbli- 
cassimo il file in una cartella contenente un file 
denominato primo.mp3, otterremmo la riproduzio- 
ne del suono. Osservando il codice, verifichiamo che 
i due aspetti del meccanismo (caricamento ed ese- 
cuzione) sono fortemente correlati tra loro, per que- 
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sto, nel nostro caso è necessario separarli. Il codice 
che si trova nel primo fotogramma del filmato esem- 
piobase.fla è caratterizzato da due funzioni ricorsive: 
caricaQ ed eseguiQ. In particolare, la funzione cari- 
cai), oltre ad applicare in sequenza il metodo load- 
SoundO per tutti i file MP3 segnalati dal documento 
XML, crea un Array chiamato caricati a cui aggiunge 
di volta in volta nuovi elementi tramite metodo 
pushQ. La funzione eseguiO è strutturata in modo ta- 
le da verificare continuamente se esiste un nuovo 
elemento nell'array caricati. Non appena viene se- 
gnalata la presenza di un nuovo file caricato, si appli- 
ca il metodo startQ per quello specifico suono. 



pagina, sul suo hard disk non è stata precedente- 
mente depositata alcuna informazione, per cui la 
condizione ifO non è vera. In questo caso vengono 
eseguite le istruzioni associate alla condizione else, 
che caricano il documento listafile.xml. Nelle ulti- 
me tre righe di codice viene creato il cookie: al suo 
interno la stringa "visto" è assegnata alla proprietà 
vis. La presenza di questa stringa ci consente di veri- 
ficare se il cookie è stato depositato: nel caso in cui, 
recuperando il valore di vis attraverso la variabile 
confronta, otteniamo "visto", viene caricato il file 
bentornato.xml. 




IL MESSAGGIO 
DI BENTORNATO 

Un messaggio di questo tipo serve ad accogliere un 
utente che ha già visitato la nostra pagina web: per 
realizzarlo dobbiamo ricorrere ad un cookie creato 
direttamente con Flash. 

A partire dalla versione MX infatti, Flash consente di 
depositare file con estensione .sol sulla macchina 
dell'utente. Con questo metodo, ogni volta che viene 
attivato il filmato SWF, possiamo verificare se l'uten- 
te possiede il cookie sul suo hard disk. Se il cookie è 
assente, viene caricato file listafile.xml che innesca 
la sequenza di MP3 a partire dal messaggio benve- 
nutol.mp3; in caso contrario viene caricato un altro 
file XML chiamato bentornato.xml, che innesca la 
sequenza di MP3 a partire dal messaggio bentorna- 
to.mp3. Creiamo file bentornato.xml scrivendo gli 
elementi illustrati nella Fig. 4 e salviamolo nella soli- 
ta cartella paginajtveb. 

A questo punto, dobbiamo solo aggiungere il codice 
necessario alla creazione del cookie. Il codice in que- 
stione, da inserire al posto dell'istruzione archivio- 
.load("listafile.xml"), l'ultima dello script contenuto 
in esempiobase.fla, è il seguente: 

shared=SharedObject.getLocal("vis"); 

confronta=shared.data.vl; 

if (confronta = = "visto") 

{ 

archi vio.load("bentornato. xml"); 

} 

else 

{ 

archivio. load("listaf ile. xml"); 

// crea il cookie 

shared = SharedObject.getLocal("vis"); 

shared. data, vi =" visto"; 

shared.flush(); 
} 

Lo script, prima di tutto, si accerta della presenza del 
cookie. Essendo la prima volta che l'utente visita la 



CONCLUSIONI 

Osservando il file index.htm presente nella cartella 
esempio _completo, noterete, oltre al commento so- 
noro, che la pagina web è associata a finestre 
DHTML che si aprono vicino ai link descritti. Questo 
effetto si basa sul sempli- 
ce utilizzo dei cosiddetti 
layer (conosciuti in ita- 
liano anche come livelli): 
si tratta di tag <DIV>- 
</DIV> contraddistinti 
da una serie di attribuiti 
attraverso i quali è possi- 
bile collocare elementi 
HTML su livelli sovrap- 
posti. I layer possono es- 
sere resi invisibili o man- 
tenuti visibili, sia attra- 
verso comuni attributi 
HTML, sia dinamica- 
mente tramite Java- 
Script. Con Dreamwea- 
ver MX 2004 sono stati 
creati otto layer (uno per 
ogni messaggio), impo- 
stati come invisibili. È 
stata aggiunta anche un 
breve funzione Java- 
Script in grado di render- 
li visibili a certe condi- 
zioni. Poiché le didascalie devono essere sincroniz- 
zate con i file audio, è stato necessario innescare la 
funzione JavaScript tramite Flash. Anche in questo 
caso, per rendere il tutto facilmente aggiornabile, a 
dettare l'ordine di apparizione delle finestre DHTML 
è il file XML importato da Flash. Poiché lo spazio è 
tiranno, affronteremo questo argomento sul prossi- 
mo numero. Per adesso, se volete iniziare a dare 
un'occhiata al meccanismo, nella cartella esem- 
pio_completo sono disponibili i file XML e HTML, 
mentre nella cartella tutoriali 'sorgenti Jlash si trova il 

file audio.fla 

Maurizio Battista 



28 function caricali] i 

29 suono[i] . onLoad = function (conferma: Boolean) :Void { 

30 if (conferma) { 

31 caricati . push (elenco [ i] ) ; 

32 ++i; 

33 carica ( i) ; 

34 } 

35 } 

36 suono [ i] . IoadSound (elenco [ i] , false); 

37 ) 
36 // funzione che esegue i suoni in sequenza 

39 function esegui (s :Numtaer) :Void{ 

40 root . onEnterFraitie=f unct ion ( ) { 

41 if (caricati [s] ! =undef ined) { 

42 suono [s] . start () ; 

43 delete _root . onEnterFrame; 

44 } 
H setlnterval (ciclo, 500) ; 

46 function ciclo () :Voicl{ 

47 suono[s] . onSoundComplete=f unct ion ( ) { 

48 p+=l; 
4© esegui (s+=l) ; 

50 clear Interval (e) ; 

51 ) 

52 } 

53 } 

54 } 

55 esegui (0) ; 

56 > 

57 archivio . lo ad ( "listaf ile . xml") ; 



Fig. 4: II file bentornato.xml, presenta una diversa 
sequenza di MP3 da caricare ed eseguire. 
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J2ME Provisioning in MIDP 2.0 



Eseguire i MIDIet 
sui cellulari 

Non è gratificante sviluppare MIDIet se poi non possiamo vederli 
in esecuzione. Daremo uno sguardo alle varie possibilità per far 
"girare" le nostre applicazioni J2ME sui nostri cellulari. 




□ i 



CD J WEB 

MiaMidletzip 
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jn 




REQUISITI 



— Dimestichezza con 
>—i Eclipse ed EclipseME 



i 



Sun Wireless Toolkit 2. 1 
Lo scarichi da: 
http://java. sun.com/ 
products/|2metoolkit/ 

Li trovi nel CD: 

• Sun JDK 1.4.2_03 

• Eclipse 3.0M9 

• EclipseME 0.4.0 




Nell'articolo del numero scorso di ioProgram- 
mo dedicato al J2ME, dopo aver creato 
un'applicazione che metteva insieme no- 
zioni legate allo sviluppo di GUI e ai protocolli di rete 
sotto MIDP e CLDC, ci siamo lasciati con la promes- 
sa di vedere come i MIDIet venissero installati sui 
nostri cellulari per poterli ammirare finalmente dav- 
vero in azione. Per chi si fosse perso la rivista del 
mese passato, in questo numero c'è la recensione di 
EclipseME nella quale potete trovare una (seppur 
molto breve) introduzione a quello che J2ME rap- 
presenta. Ovviamente, per poter portare un'applica- 
zione sul nostro dispositivo mobile, dobbiamo in- 
nanzitutto avere l'applicazione! Al fine di non di- 
strarre l'attenzione dall'obiettivo primario della no- 
stra discussione, utilizzeremo un MIDIet molto sem- 
plice, praticamente lo stesso creato nella recensione 
di EclipseME menzionata poc'anzi, con l'aggiunta 
solo di un Ticker, giusto per poter vedere qualcosa 
che si muove. 



IL MIDLET 

Partirò dal presupposto che stiate utilizzando Eclip- 
se per lo sviluppo Java insieme al plug-in EclipseME 
per la creazione di progetti wireless e che abbiate 
installato il Sun Wireless Toolkit 2.1 come run-time 
J2ME. In realtà, l'unica cosa importante è che alla 
fine di questa sezione abbiate una MIDIet Suite 
impacchettata in un JAR e con relativo file di descri- 
zione JAD. Utilizzando i wizard di EclipseME, creia- 
mo quindi il nostro progetto MIDIet Suite e con- 
figuriamolo per MIDP 1.0, onde evitare problemi di 
compatibilità di versione con il cellulare: anche se 
siete sicuri che MIDP 2.0 sia supportato, potrebbe 
non essere però supportato CLDC 1.1, e bisognereb- 
be mettersi a modificare il JAD (niente di trascen- 
dentale, ma per ora vogliamo che fili tutto super-li- 



scio!). Sempre con i wizard, creiamo adesso un nuo- 
vo MIDIet dentro il progetto appena generato, dan- 
dogli, per esempio, il nome di ProvisioningMidlet (il 
perché della mia scelta sarà chiaro un po' più avan- 
ti) nel package mymidlets ed implementando l'in- 
terfaccia CommandListener di MIDP II codice com- 
pleto del MIDIet lo trovate nel Listato 1, con i com- 
menti eliminati per questioni di spazio. Come pote- 
te notare, si tratta di un'applicazione J2ME molto 
semplice. A livello di istanza della classe definiamo 
la schermata principale (scrMain), un ticker [tkr- 
Banner, si tratta di una scritta che scorre, normal- 
mente in alto sul display del cellulare) ed un coman- 
do (cmdExit). La schermata è una semplicissima 
TextBox, a cui aggiungiamo il ticker tkrBanner e che 
avrà infine come unico comando il nostro cmdExit 
che utilizzeremo per permettere all'utente di uscire 
dall'applicazione. La gestione del comando avverrà 
ad opera del MIDIet stesso nel metodo di callback 
commandAction, obbligatorio dato che abbiamo 
scelto di implementare CommandListener. 
Dei metodi del ciclo vitale del MIDIet (startApp, pau- 
seApp, e destroyApp), l'unico che necessita di imple- 
mentazione nel nostro caso è startApp, dove impo- 
stiamo nostro screen scrMain come display cor- 
rente dell'applicazione dopo avergli aggiunto ticker 
e command. Infine, sempre nello stesso metodo, di- 
chiariamo che i comandi di scrMain devono essere 
gestiti dal MIDIet ad opera della chiamata setCom- 
mandListener. A mo' di ripasso, e per venire incontro 
a chi si avvicina per la prima volta al J2ME, ricordia- 
mo solo alcuni punti fondamentali relativi alle 
applicazioni per dispositivi mobili. Il MIDIet rappre- 
senta l'applicazione J2ME ed ha tre stati vitali: non- 
esiste, attiva, in-pausa. Quando chiediamo al nostro 
cellulare di eseguire un programma Java, questo 
istanzia il MIDIet (invocandone così il costruttore, 
che funge da inizializzatore dell'applicazione) ed in- 
voca il metodo startApp. Se mentre state utilizzando 
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F/g. 1: La configurazione del debugger di Eclipse per 
EclipseME. 

il software qualcosa ne interrompe l'esecuzione (per 
esempio, vi squilla il cellulare o vi arriva un SMS), il 
codice verrà messo in pausa a seguito di una chia- 
mata a pauseApp, dove il programmatore può even- 
tualmente salvare lo stato dell'applicazione. Alla fine 
della vostra conversazione telefonica o dopo che 
avete letto il messaggio di testo, il cellulare rimette in 
moto il MIDlet, invocando di nuovo startApp: siete 
voi programmatori a dover sapere in qualche modo 
che l'applicazione era già stata fatta partire prima. 
Infine, per eliminare del tutto l'applicazione dalla 
sua memoria, il cellulare distruggerà il MIDlet, invo- 
cando il metodo destroyApp prima di eliminare l'og- 
getto. Tenete sempre a mente che i tre metodi visti 
appena adesso, come già spiegato nell'articolo del 
mese scorso, sono delle notifiche da parte del siste- 
ma verso la nostra classe: se nel codice del MIDlet 
ho necessità di mettere in pausa l'applicazione o 
distruggerla, non ha senso chiamare pauseApp o 
destroyApp solamente, devo richiedere l'operazione 
al sistema con notifyPaused o notifyDestroyed. In 
maniera del tutto simile, se voglio far ripartire il 
MIDlet in pausa (ad esempio da un thread parallelo 
in esecuzione), invocherò resumeRequest, ma in 
questo caso startApp sarà invocato automaticamen- 
te dal sistema quando l'applicazione viene rimessa 




Fig. 2: Esecuzione in debug di un MIDlet sotto l'emu- 
latore con EclipseME. 



in moto {pauseApp e destroyApp devono invece es- 
sere invocati esplicitamente dal programmatore). 
Relativamente alle interfacce grafiche, ricordiamo 
infine che i dispositivi compatibili con il profilo 
MIDP mettono a disposizione il loro display per la 
visualizzazione di uno screen (schermata) alla volta 
da parte delle applicazioni. Un riferimento al display 
del cellulare lo si ottiene 




package mymidlets; 



Display d = Display.getDisplay(this); 
if (d.getCurrent() == nuli) { 



scrMain.setTicker(tkrBanner); 

scrMain.addCommand(cmdExit); 

scrMain.setCommandListener(this); 



d.setCurrent(scrMain);}} 
protected void pauseApp() {} 



con il metodo statico get- 
Display di Display, men- 
tre per ottenere o impo- 
stare lo screen corrente si 
usano getCurrent e set- 
Current dello stesso og- 
getto. Un'applicazione 
I2ME complessa svolge 
buona parte del suo lavo- 
ro modificando lo screen 
corrente per offrire le va- 
rie parti della propria in- 
terfaccia grafica. Ogni 
istanza di uno screen può 
poi definire un proprio 
menu di comandi trami- 
te una serie di oggetti 
Command aggiunti ad 
opera del metodo add- 
Command: sarà il cellula- 
re a stabilire dove questo 
menu sarà visualizzato in 
base alla propria grafica, 
mentre per ricevere la 
scelta dell'utente è ne- 
cessario implementare 
CommandListener per 

avere il metodo di notifica commandAction, che vi 
passa comando selezionato e lo screen attivo. 
A questo punto, testiamo rapidamente la nostra ap- 
plicazione per essere sicuri che funzioni sull'emula- 
tore prima di portarla sul cellulare. Accertatevi, in- 
nanzitutto, di aver configurato correttamente i para- 
metri del debugger fava per poterlo usare con Eclip- 
seME (vedi Fig. 1). Selezionate il MIDlet Provisio- 
ningMidlet nella view del Package Explorer e selezio- 



import javax.microedition. Icdui.*; 

import javax.microedition. midlet.*; 

public class ProvisioningMidlet extends MIDlet 

implements CommandListener { 
private Command cmdExit = new Command("Esci 

dal MIDlet", Command. EXIT, 0); 



private Ticker tkrBanner = new Ticker(" 
ioProgrammo - Federico Mestrone - J2ME Tutorial"); 



private Screen scrMain = new TextBox("Welcome", 
"Questo è il mio primo MIDlet!", 100, TextField.ANY); 
public ProvisioningMidlet() { 



superQ;} 

protected void startApp() throws 

MIDIetStateChangeException { 



protected void destroyApp(boolean argO) throws 

MIDIetStateChangeException {} 

public void commandAction(Command argO, 

Displayable argl) { 
if (argO == cmdExit) { 
try { destroyApp(false); 



notifyDestroyed();} 
catch (MIDIetStateChangeException msce) {} 



}} } 



LISTATO 1: Il MIDlet da portare sui nostri cellulari 



l loProgramrno - Federico Mestrone 
Welcome 



r 



Questo è il mio primo MIDlet 



' «Esci dal MIDlet 




Fig. 3: Il display dell'emulatore con lo screen del nos- 
tro MIDlet. 



Fig. 4: Il nostro MIDlet 
gira su un cellulare vir- 
tuale. 
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APPROFONDIMENTI 



KVM, CLDC 
EMIDP 

Il J2ME per i piccoli 

dispositivi mobili 

(cellulari e PDA) 

definisce una 

configurazione di base 

(detta CLDC) che 

include la definizione 

di una macchina 

virtuale alleggerita (la 

KVM) e una libreria 

per l'accesso alle 

funzionalità essenziali 

dell'hardware (I/O, 

gestione della 

memoria, etc). Ad un 

livello superiore, il 

profilo (MIDP) prevede 

una libreria rivolta ai 

programmatori J2ME 

per lo sviluppo di 

applicazioni e la 

creazione delle 

interfacce grafiche. 




Fig. 5: Preparare la MIDIet Suite con il menu di 
EclipseME. 



nate il menu Run->DebugAs->Emulated J2ME Mid- 
let, oppure utilizzate la toolbar come in Fig. 2. Dopo 
alcuni istanti dovreste vedere l'emulatore del Sun 
Wireless Toolkit aprirsi e a seguito di una breve pausa 
la vostra applicazione appare sul display del cellula- 
re virtuale (vedi Fig. 4). Nella Fig. 3 abbiamo uno 
zoom sul display del dispositivo con il nostro screen 
come corrente. Riconoscerete nella figura ticker 
(contrassegnato dal cerchio giallo 1), il titolo dello 
screen impostato nel costruttore della TextBox (cer- 
chio 2) e il nostro unico comando (cerchio 3) che ha 
preso il posto normalmente lasciato al menu conte- 
stuale dell'apparecchio. 
Il resto dello screen è occupato dalla casella di testo. 



LA MIDLET SUITE 

Adesso non ci resta altro che prepararci per installa- 
re l'applicazione Java sul nostro cellulare compatibi- 
le J2ME. Per prima cosa chiediamo ad EclipseME di 
organizzare tutto il materiale necessario sparso per 
il progetto Eclipse in una MIDIet Suite standard. 
Questa operazione si concretizzerà nella generazio- 
ne di un' accoppiata JAR +JAD pronta per il provisio- 
ning, ovvero sia la distribuzione su dispositivo J2ME 
(questo termine tecnico ha dato anche il nome alla 
nostra classe MIDIet, se ricordate!). La procedura è 
molto semplice: click col destro sul progetto, menu 
J2ME->Create Package (come in Fig. 5). Nella cartel- 
la deployed (invisibile nel Package Explorer a causa 
di un filtro) avrete ciò che serve per il provisioning. 
A questo punto esportiamo da Eclipse i due file che 
ci servono: menu File->Export..., esportate come 
File System, poi selezio- 
nate solo la cartella de- 
ployed del vostro proget- 
to MIDIet Suite e scegliete 
un percorso di destina- 
zione a voi comodo dove 
mettere il tutto: la scher- 
mata di export la trovate 
in Fig. 6. Da adesso, 
quando parlo della no- 
stra MIDIet Suite mi rife- 
risco ai due file che stia- 
mo esportando in questo 
momento, quindi tenete 
bene a mente dove li sta- 
te mettendo! 



IL PROVISIONING 

Giunti fino qui, ora dobbiamo scegliere come porta- 
re il nostro codice sul cellulare per poterlo mettere in 
esecuzione. Nel numero scorso avevamo accennato 
all'AMS {Application Management Software, detto 
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Fig. 6: Esportazione della MIDIet Suite (JAR e JAD) 
da Eclipse. 

anche Java Application Manager o JAM). Questo 
programma si occupa dell'installazione delle appli- 
cazioni J2ME sui dispositivi MIDP ed è proprio 
dell'AMS che avremo bisogno per il provisioning. 
Esso infatti viene tirato in ballo ogniqualvolta abbia- 
mo a che fare con JAD e JAR. Abbiamo due opzioni 
davanti a noi: la prima richiede che si stabilisca una 
connessione tra il PC ed il telefonino, la seconda in- 
vece può prescindere da questa comunicazione, ma 
non è detto che sia supportata dal vostro modello di 
cellulare. Se optate per la prima possibilità, ci sono 
normalmente tre varianti per mettere in contatto il 
computer con il telefono: l'infrarosso, Bluetooth, op- 
pure un cavo seriale che si connette al cellulare. È 
chiaro che qui ci stiamo addentrando in territorio 
minato, perché la soluzione ideale in questo caso 
dipende da molti fattori, non ultimo dei quali le 
capacità dei nostri hardware (mobili e non). Di fatto 
queste tecnologie non prevedono altro che il trasfe- 
rimento di un file dal PC al telefono, e l'utilizzo espli- 
cito dell'AMS da parte dell'utente per installare e 
mettere in esecuzione la Suite scaricata. La modalità 
di trasferimento delle risorse va valutata di volta in 
volta consultando le specifiche del driver e del soft- 
ware che state utilizzando ed è quindi difficile dare 
delle direzioni generiche in questo senso. La secon- 
da possibilità, invece, offre un approccio che non ri- 
chiede di connettere PC e cellulare ed è decisamen- 
te più generica della prima. Si tratta dell'OTA (Over 
Tlie Air) provisioning ed è una modalità divenuta 
obbligatoria per i dispostivi J2ME a partire dalla ver- 
sione 2 del profilo MIDP anche se è comunque spes- 
so supportata da apparecchi con MIDP 1. In base a 
questo protocollo di distribuzione, il programmato- 
re mette il proprio lavoro (nel senso di JAR e JAD!) 
sotto la document root di un web server di modo 
che sia possibile scaricare la MIDIet Suite da brow- 
ser. Dall'altro lato, il dispositivo wireless effettua una 
connessione a Internet ed accede all'indirizzo a cui 
è raggiungibile file JAD di descrizione. Ricono- 
scendo la tipologia di contenuto scaricato, il cellula- 
re passerà il file .jad all'AMS, il quale - grazie alla 
voce MIDIet- Jar- URL del file .jad stesso (configurata 
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automaticamente da EclipseME se lo usate) - sarà in 
grado di andarsi a scaricare anche il file .jar e di dare 
inizio alla procedura di installazione, chiedendo le 
dovute conferme al proprietario. L'unico punto in 
cui è richiesta un po' di manipolazione è la configu- 
razione del web server: a quel livello, infatti, è neces- 
sario che venga inviata un'intestazione HTTP corret- 
ta quando sono richiesti i file jad e jar affinché il 
Content-Type che arriva al cellulare sia rispettiva- 
mente un tipo MIME textlvnd.sun.j2me.app-de- 
scrìptor e application/java. Questa semplice associa- 
zione tra un'estensione di file ed una stringa di tipo 
MIME ovviamente dipende dal web server che state 
usando. 





Indi Ti ii ii ni 1 
1 Lnter URL 

1 up: previous 
[ 1 down: completion 


1 
1 / 


^ :/Miariìdleti.uite.Sad | 





Fig. 7: OTA Provisioning: Immetto sul browser 
l'indirizzo del file .jad. 



L'APPLICAZIONE 
SUL TELEFONINO 

Analizziamo adesso la nostra suite. Il mio web server 
è Apache, per cui prendo il file httpd.confed aggiun- 
go le seguenti due linee: 

AddType text/vnd.sun.j2me.app-descriptor .jad 
AddType application/java .jar 

che fanno sì che a fronte di un .jad o .jar il server dia 
come contenuto MIME la stringa specificata. A que- 
sto punto faccio l'upload di MiaMidletSuite.jad e 
MiaMidletSuite.jar (quelli che avete esportato da 




Fig. 9: OTA Provisioning: L'AMS installa la Suite pre- 
via conferma. 

Eclipse o se volete quelli dal CD allegato) sulla docu- 
ment root del mio host tramite ftp (la mia cartella è 
/var/www, ma questo dipende dall'installazione di 
Apache). Adesso verifico dal mio PC che i file siano 
effettivamente raggiungibili via internet, navigando 
all'indirizzo http://<nome del vostro host>IMiaMid- 
letSuite.jad, e ovviamente cancello quando il brow- 
ser mi propone di scaricare. Faccio la stessa prova 
con MiaMidletSuite.jar e, se anche quella è raggiun- 
gibile, sono pronto a passare al cellulare. Sul mio 
Nokia 6600, apro il browser Opera (dovete avere già 
configurato il gateway per l'accesso Internet via 
GPRS: chiedete al vostro operatore di telefonia, ci 
pensano loro) ed immetto l'URL del file JAD (Fig. 7). 
Appena il server risponde, viene invocato l'AMS per 
prendere in carico il file di tipo textlvnd.sun.j2me 
.app-descriptor (Fig. 8), e l'AMS provvede a scaricare 
il JAR e ad installarlo previa conferma (Fig. 9). 




Fig. IO: I MIDIet della Suite fanno ora parte del menu 
del telefonino. 



Ora nel menu del mio telefonino ho a disposizione 
una voce nuova (Fig. 10), e se provo a selezionarla. . . 
mi ritrovo (Fig. 11) la mia prima applicazione MID- 
Iet! 





GLOSSARIO 



MIDLET E 
MIDLET SUITE 

Il MIDIet è la classe Java 
che incorpora un'appli- 
cazione J2ME, imple- 
mentandone le varie fa- 
si del ciclo vitale e for- 
nendo il punto di par- 
tenza per l'interazione 
con l'utente. La MIDIet 
Suite invece è l'insieme 
di un file JAR dove sono 
raccolti uno o più MID- 
Iet, unito ad un descrit- 
tore delle applicazioni 
contenute che è il file 
JAD. 




APPROFONDIMENTI 



Sul sito OnJava, 
all'indirizzo 
www.oniava.com/topics 
/java/Wireless Java 
trovate un'intera 
sezione dedicata al 
wireless e allo sviluppo 
di MIDIet. È un ottimo 
punto di partenza per 
approfondire le vostre 
conoscenze e trarre 
ispirazione per le 
vostre applicazioni 
J2ME. 

Nel frattempo, se vi 
sorge qualche dubbio 
sul materiale di questo 
articolo, potete sempre 
contattarmi all'email 
federico.mestrone© 
ioprogrammo.it! 



Fig. 8: OTA Provisioning: Il cellulare riconosce che il 
file è per l'AMS. 



Fig. 11: Il MIDIet in esecuzione su un Nokia 6600. 

Federico Mestrone 
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Automatizzare la gestione di magazzino con tag a radiofrequenza 

Un gestionale 
a radiofrequenza 

La gestione di un magazzino è per molte aziende una delle parti 
cruciali dell'attività. Vediamo come le tecnologie attuali ci aiutano 
a semplificare tutto ciò, velocizzando il nostro lavoro. 




□ CD □ WEB 

Radio1requenza.zip 



*k 




REQUISITI 



Conoscenze richieste 



— C#, conoscenze di base 
ì~' del protocollo RS232 



Windows 

98/ME/2000/XP/2003, 
.net Framework + SDK, 
preferibilmente Visual 
Studio .net 2003 



Tempo di realizzazione 



La gestione informatizzata di un magazzino 
ha come scopo principale quello di rispon- 
dere a domande tipo: quanta merce ho in 
magazzino? Ne ho abbastanza? Quanto vale il 
mio magazzino oggi? Dove si trova il prodotto 
xyzì Per rispondere a queste domande, numero- 
se software house hanno realizzato decine di 
prodotti accomunati da una logica semplice ed 
abbastanza efficace: si inseriscono le quantità 
della merce arrivata, si tolgono quelle della mer- 
ce in uscita e si ottiene il totale magazzino. 
Questo dovrebbe bastare a garantire l'integrità 
dei dati ma, chiunque ha dovuto gestire un ma- 
gazzino, sa che purtroppo non è sempre così e 
periodicamente va fatto un inventario. Il tempo 
necessario ad effettuare l'inventario dipende da 
tre fattori fondamentali: 

• la quantità di prodotti presenti 

• il numero di persone coinvolte 

• il sistema utilizzato per fare l'inventario 

Inutile precisare che maggiore sarà il tempo im- 
piegato, maggiore sarà il costo dell'operazione! 
Essendo programmatori e non potendo agire sui 
primi due punti, vedremo come agire sul terzo 
sfruttando nuove tecnologie sia software che 
hardware, per velocizzare le operazioni comuni. 
Alla fine di questi articoli avremo un software che 
ci consentirà di gestire un magazzino in tempi 
rapidi e fare un inventario senza muovere i pro- 
dotti dagli scaffali. Entreremo nel futuro degli 
RFID, la tecnologia ancora in fase di sperimenta- 
zione che promette di rivoluzionare il settore 
della logistica e vedremo come usarla nei nostri 
software. Che dobbiate occuparvi di un negozio 
di abbigliamento, di un rivenditore di pezzi di ri- 
cambio o di un grande magazzino, avrete a di- 
sposizione una base da cui partire. Iniziamo... 



I TAG 

Uno dei componenti di maggiore importanza nei 
sistemi di gestione magazzino è l'etichetta: 
siamo ormai abituati a vedere un codice a barre 
su qualsiasi prodotto in commercio. Sebbene 
questo sistema sia ormai enormemente diffuso, 
non è esente da problemi e limiti tecnologici. 




Fig. 1: Un tag a radiofrequenza. 

In primo luogo, l'etichetta può facilmente dete- 
riorasi rendendo il codice illeggibile. In secondo 
luogo, l'utilizzo dei codici a barre è sconsigliato 
in ambienti polverosi. Basta infatti una piccola 
macchia sul codice per renderlo illeggibile. 
Queste problematiche sono tutte legate ad una 
caratteristica intrinseca del sistema: il lettore 
deve poter "vedere" il codice, pena la non leggi- 
bilità. La soluzione a questi problemi arriva con 
l'avvento dei tag (o transponder) a radiofrequen- 
za. Il loro scopo è fondamentalmente quello di 
trasmettere il codice univoco memorizzato al lo- 
ro interno ad un apposito lettore, attraverso una 
trasmissione radio che lavora su una frequenza 
ben definita. I tag a radiofrequenza si distinguo- 
no in due famiglie principali: attivi e passivi. 
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Quelli attivi possono trasmettere autonomamen- 
te il loro codice che può essere letto da una di- 
stanza di 15/20 metri, il che li rende particolar- 
mente adatti in alcuni campi applicativi come, 
ad esempio, il Telepass autostradale. Lo svantag- 
gio è che devono essere alimentati da una fonte 
esterna, cosa che li rende ingombranti e costosi. 




Fig. 2: II dettaglio di un tag in cui è chiaramente 
visibile l'antenna e la parte attiva. 

I tag passivi sono invece piccoli, leggeri ed econo- 
mici. Sono costituiti da una memoria non volati- 
le (in cui è memorizzato un codice univoco), un 
circuito di trasmissione ed una antenna il cui 
scopo è di alimentare memoria e circuito di tra- 
smissione. Il principio di funzionamento di que- 
sti tag è molto semplice: il lettore genera un 
campo elettromagnetico che viene captato dal- 
l'antenna del tag. Tale campo genera, per indu- 
zione, una tensione elettrica che carica un picco- 
lo condensatore. Quando la tensione ai capi del 
condensatore raggiunge un determinato valore, 
il circuito di trasmissione del tag trasmette il co- 
dice contenuto nella memoria non volatile. Tutto 
il procedimento avviene in poche frazioni di se- 
condo rendendo possibile la lettura di molti tag 
in brevissimo tempo. La distanza di utilizzo però, 
a differenza dai tag attivi, si riduce a pochi centi- 
metri (20-30cm). Ogni famiglia si suddivide poi 
in tag di sola lettura e tag scrivibili, il che aumen- 
ta notevolmente la loro flessibilità rispetto ai 
codici a barre. Il costo dei tag passivi di sola let- 
tura si aggira intorno a € 0,70 cadauno se ne 
compriamo almeno 1000. Tale costo varia co- 
munque in base al quantitativo ordinato ed è co- 
munque destinato a scendere nel tempo cam- 
biando probabilmente ordine di grandezza. Ri- 
spetto al codice a barre, la lettura dei tag è molto 
più comoda data l'assenza di contatto fisico tra il 
tag ed il lettore. Leggere il codice anche senza che 
il lettore "veda" l'etichetta, rende questo sistema 
più veloce e pratico rispetto ai sistemi attual- 
mente utilizzati. 



LETTORI RFID 

Nel precedente paragrafo abbiamo visto che in 
commercio esistono diversi tipi di tag, utilizzabi- 
li in campi applicativi diversi. I lettori dovranno 
quindi essere scelti in base alla tipologia di tag 
che abbiamo intenzione di utilizzare. Il lettore 
più comune è molto simile ad un lettore di codi- 
ce a barre tradizionale. In commercio si trovano, 
oltre ai lettori palmari, anche lettori da tavolo, da 
parete, da varco ecc., tutti collegabili sia diretta- 
mente ad un elaboratore, che a mezzo di oppor- 
tuni concentratori (un po' come gli HUB in una 
rete lan) . Ciò che differenzia i lettori di tag sono 
sostanzialmente due fattori: la frequenza di lavo- 
ro e la distanza di lettura. I tag, infatti, sono pro- 
dotti con moduli di trasmissione a radiofrequen- 
za diversi al fine di rispettare le normative in 
vigore nei paesi di utilizzo. Sia il lettore che il tag 
devono dunque "parlare" sulla stessa frequenza. 
La distanza di lettura è l'altro fattore caratteristi- 
co dei lettori di tag. Si va da quelli di prossimità, 
la cui distanza massima di lettura è di 20/30 cm, 
a quelli a lungo raggio che, abbinati ai tag attivi 
(quelli con batteria integrata), permettono la let- 
tura fino a 15/20 metri di distanza. I costi dei let- 
tori variano in base alla tipologia scelta e vanno 
da un minimo di € 250,00 a salire. Come per i tag, 
anche il prezzo dei lettori è destinato a scendere 
proporzionalmente alla loro diffusione. 




Fig. 3: Un classico lettore di tag palmare. 

In questi articoli vedremo come utilizzare in ac- 
coppiata i lettori palmari e i tag passivi. 



LEGGIAMO I TAG 

Ora che sappiamo cosa sono i tag a radiofre- 
quenza, come funzionano e come si leggono, ini- 
ziamo a fare qualche esperimento. In commercio 
si trovano ormai decine kit per testare questa tec- 
nologia il cui costo si aggira intorno a € 300,00. 
Mi rendo conto che spendere tale somma per la 
sola sperimentazione possa scoraggiare qualcu- 




Un sito ricco di 
prodotti relativi a 
questa tecnologia è 
http://buyrfid.com/catalog 
/default.php . 
Sfogliandolo potrete 
farvi un'idea dei costi 
di implementazione 
nonché delle soluzioni 
disponibili sul mercato. 
Considerate sempre 
che, specie per i tag, i 
prezzi variano in 
relazione al 
quantitativo 
acquistato. 
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no quindi, per ovviare al problema, nel codice 
allegato alla rivista è presente un tool che simula 
via software la lettura dei tag. Il primo ostacolo 
che dovremo affrontare è quello relativo alla ge- 
stione della porta seriale. Il .net framework non 
ha, al momento, classi interne (managed) per la 
gestione delle porte seriali. Fortunatamente però 
attraverso il Platform Invocatìon {PInvoke del na- 
mespace System.Runtime.InteropServices), è possi- 
bile utilizzare delle APIs Win32 (unmanaged) 
anche in progetti .net. Basta una ricerca su inter- 
net per vedere che molti sviluppatori hanno già 
realizzato delle librerie pronte all'uso. Essendo 
un argomento abbastanza vasto, la cui trattazio- 
ne andrebbe al di fuori dello scopo di questo arti- 
colo, ci limiteremo ad usare una di queste libre- 
rie commentandola solo quando serve. Tra le 
tante disponibili in Rete, ho scelto quella scritta 
da un programmatore Italiano: Corrado Cavalli, 
MVP (MostValuable Professional) in .net. La libreria 
di Corrado è scritta in VB.net ma vedremo come 
sia possibile farlo convivere senza problemi con 
C#. Creiamo una nuova soluzione in Visual 
Studio .net relativa al nostro progetto che chia- 
meremo TagGest. Al suo interno, realizziamo una 
nuova libreria di classi Visual Basic che chiame- 
remo rs232 in cui copieremo il file rs232.vb conte- 
nuto nel codice allegato. 

Il passo successivo sarà quello di creare una pic- 
cola applicazione per verificare il corretto fun- 
zionamento del sistema. La base di tale applica- 
zione costituirà poi il modulo di ricezione del 
nostro software. Creiamo dunque una nuova 
applicazione Windows che chiameremo TagGest 
(come la soluzione), scegliendo questa volta C# 
come linguaggio. Il form principale deve avere 
una texbox in cui leggeremo i dati in arrivo sulla 
seriale, ed un bottone che ci permetta di aprire 
tale porta al fine di riceverne i dati (vedi Fig.5). 



r 

[a Ricezione dal lettore di Tags | - | 










Ricezione dei dati dal lettore 






TAGCODE 
TAG CODE 
TAG CODE 
TAG CODE 
TAG CODE 
TAG CODE 
TAG CODE 


D1 1 1 1 1 DFDD671 5E3 
01 1 1 1 1 QF00671 5E4 
D1 1 1 1 1 0F00S71 5E5 
D111110FDD6715E6 
D1 1 1 1 1 QFD0G71 5E7 
D1 1 1 1 1 DFDDS71 5ES 
D111110FD06715ES 
















Ricevi 






Premere ' Ricevi" per avviare la ricezione dei dati 





Fig. 5: II Form principale del progetto TagGest. 

Per poter usare la libreria di gestione della rs232 
che abbiamo creato all'inizio, dobbiamo innan- 
zitutto referenziarla al progetto TagGest. Per farlo, 
clicchiamo con il tasto destro del mouse sulla 
cartella References del progetto TagGest, selezio- 
niamo la voce "Aggiungi Riferimento", scegliamo la 
cartella "Progetti" e selezioniamo rs232. Confer- 
mata l'operazione, saremo pronti ad usare nel 
nostro progetto la DLL scritta in VB.net. In 
forml.cs, importiamo il namespace relativo alla 
rs232 con la direttiva 

using rs232; 

e creiamo una istanza statica di rs232 

private static Rs232 r = new Rs232(); 

L'apertura della porta avviene alla pressione del 
bottone "Ricevi", avendo però prima settato alcu- 
ni parametri fondamentali come la porta su cui 
ricevere i dati, la velocità ecc.: 



Nuovo progetto 



Tipi progetto: 






Modelli: 



■■CU Progetti di installazione e distribuzione 
F±] CJ Altri progetti 

I I Soluzioni di Visual Studio 



Applicazione 
per Windows 




l V BJ 

a di 



Libreria di 
control,,, 



Applicazione Servizio Web Applicazione 
WebASP.NET ASP.NET Web niobi... 



Progetto per la creazione di dassi da utilizzare ij^hre applicazioni 
Nome: | rs232| 

Percorso: | C: 'pocurnents and SettingsV<1ighellV)oajmenti\Visual S ^J Sfoglia. 

Il progetto verrà creato in C:\, , .V^Iighell'Pocument^Visual Studio Projects\testHDserialVs232, 



* Altro 



Annulla 



Fig. 4: Creazione di una Libreria di Classi Visual Basic in Visual Studio .NET. 



private void btnRicevi_Click(object sender, 

System. EventArgs e) { 

try{ 

r.Port = 1; 

r.BaudRate = 9600; 

r.DataBit = 8; 

r.StopBit = Rs232.DataStopBit.StopBit_l; 

r.Parity = Rs232.DataParity.Parity_IMone; 

r.Timeout = 1500; 

r.Open(); 
r.Dtr = true; 
r.Rts = true; 

r.RxBufferThreshold = 16; 

r.EnableEvents(); 
r.CommEvent+ = new 

rs232.Rs232.CommEventHandler(r_CommEvent); 

}catch (Exception ex){ 
textBoxl.Text = ("Errore: " + ex.Message);} } 
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Questi parametri sono variabili e dipendono 
dalle specifiche del lettore che verrà utilizzato. 
Niente paura, in questo esempio i dati sono com- 
pilati nel codice ma, nel successivo articolo, 
vedremo come recuperarli da un file di configu- 
razione in modo da non dover ricompilare l'ap- 
plicativo in caso di modifica del lettore. Di im- 
portanza rilevante è l'abilitazione alla gestione 
degli eventi attraverso l'istruzione 

r.EnableEventsQ; 

Non dimentichiamoci che la nostra applicazione 
deve restare in ascolto per ricevere i dati che arri- 
vano dal lettore. Se leggessimo solamente i dati 
dalla porta seriale con il metodo read(n), legge- 
remmo solo gli n byte che in quel preciso mo- 
mento stanno arrivando alla porta seriale. Nella 
migliore delle ipotesi, non riusciremmo a leggere 
nulla, generando una eccezione di timeout dopo 
un intervallo di tempo pari a quello settato con 
l'istruzione 

r. Timeout = 1500; 

che nel nostro caso specifico è di 1500ms. 
Lo scopo dell'istruzione r.EnableEventsQ è quello 
di avviare un nuovo thread in ascolto sulla porta 
seriale specificata nei settaggi. Lo vediamo diret- 
tamente nella classe CRs232.vb: 



If moEvents Is Noth 


ing Then 


mbEnableEvents = 


= True 


moEvents = New 


Thread(AddressOf pEventsWatcher) 


moEvents. Start() 


End If 



Quando un numero predefinito di byte (definibi- 
le con l'istruzione RxBufferThreshold) arriva sulla 
porta seriale, per il nostro applicativo vorrà dire 
che abbiamo letto il codice di un tag che quindi 
dobbiamo processare. Nel caso specifico dell'e- 
sempio, il processing che effettueremo sarà quel- 
lo di visualizzare nella textbox, i dati ricevuti sul- 
la porta. L'assembly rs232 farà scattare un evento 
di tipo CommEventa. cui avremo registrato il no- 
stro form: 

r.CommEvent+ = new rs232.Rs232.CommEventHandler( 

r_CommEvent); 

che si occuperà, attraverso il delegate Comm- 
EventUpdate, di aggiornare la textBox con il testo: 

textBoxl.AppendText("TAG CODE: " + 

source.InputStreamString + "\r\n"); 

che rappresenterà il codice appena ricevuto. 



Per effettuare i test, colleghiamo il nostro lettore al- 
la porta seriale, apriamo TagGest.exe, attiviamo la 
ricezione e leggiamo i tag con il lettore. In alterna- 
tiva, colleghiamo il cavo seriale laplink a due porte 
seriali, avviamo il programma di ricezione ed il 
simulatore {TagSimulator.exe contenuto nel codice 
allegato e comprensivo di sorgenti) ed avviamo la 
simulazione. Vedremo apparire nella textBox di 
TagGest, i codici inviati dal TagSimulator. 
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Fig. 6: L'applicazione funzionante affiancata al simula- 
tore di lettore di tag 



COSA REALIZZEREMO 

In questo primo articolo abbiamo visto cosa la 
tecnologia ci mette a disposizione per risolvere 
un problema abbastanza oneroso come la 
gestione di un magazzino. I tag a radiofrequenza, 
se usati con criterio, possono rendere più sempli- 
ce e sicuramente più economica la gestione di un 
intero magazzino. Abbiamo inoltre fatto la prima 
sperimentazione di lettura di un tag (reale o si- 
mulata), superando quello che è lo scoglio mag- 
giore: l'interfacciamento con un dispositivo 
Hardware attraverso la porta seriale del pc. Nel 
prossimo numero vedremo come utilizzare i dati 
ricevuti per popolare un archivio del nostro 
magazzino, individuare un prodotto sugli scaffa- 
li e fare un vero e proprio inventario in breve 
tempo. Un ringraziamento particolare va a 
Corrado Cavalli per la sua disponibilità. 

Michele Locuratolo 



APPROFONDIMENTI 



Per approfondire tutti i dettagli tecnici relativi alla tecnologia dei 
dispositivi a radiofrequenza utilizzati in questo articolo, consultate il sito 
http://www.ti.com/tiris/docs/docntr.htm ricco di documentazione, data sheets, 
white papers. 

Se siete interessati all'acquisto di un kit per testare direttamente la 
tecnologia, ne trovate diversi sul sito http://www.secureorderprocess.com/ti/ 
products.asp . Il kit LF Micro Eval Kit è più che sufficiente per effettuare le 
sperimentazioni necessarie. 

Il progetto completo della libreria di Corrado Cavalli è disponibile sul suo 
sito: http://www.codeworks.it/netA/BNetRs232.htm . Il progetto è scaricabile 
liberamente ed è comprensivo di tutti i sorgenti, nonché di una 
applicazione di test per verificarne l'effettivo funzionamento. 
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Costruiamo da zero un DBMS 



SQL, Java e 
Design Pattern 

La realizzazione di un database in Java è interessante per disporre 
di un motore da integrare nelle proprie applicazioni, ma anche 
per apprendere tecniche per la trattazione del testo. 



Il database è un componente fondamentale in 
molte applicazioni e tra tutte le tipologie dispo- 
nibili è sicuramente più diffuso quello relaziona- 
le, che utilizza il linguaggio SQL per creare, cancella- 
re e modificare i dati. Oggigiorno, anche le applica- 
zioni apparentemente più semplici necessitano di 
un qualche meccanismo per memorizzare le infor- 
mazioni ed i semplici file binari e di testo possono 
non bastare più per supportare le necessità dell'ap- 
plicazione. D'altronde, pare che la nuova versione di 
Windows non utilizzerà più un normale file system, 
ma una versione personalizzata di SQL Server. 



basa sulla classe ParserTokenìzer che non è altro che 
una sottoclasse di StringTokenizer, il fatto di avere 
una classe tra StringTokenizer e le classi client con- 
sente di avere un punto dove eventualmente inseri- 
re del codice personalizzato per elaborare linguag- 
gio SQL. I comandi supportati in questa versione 
sono: 

DROP DATABASE; 

CREATE DATABASE; 

CREATE TABLE; 

INSERT INTO 

SELECT; 




Q CD Q WEB 

javadb.zip 



*JZ 



<*•■•■' • ■• 



IL PROGETTO JAVADB 

In questa breve serie di due artìcoli verrà affrontata 
la realizzazione di un semplice motore di database 
SQL sviluppato completamente in Java e pensato 
per essere inserito all'interno di applicazioni stan- 
dalone. Spesso i database server vivono come pro- 
cessi separati, preferibilmente in esecuzione su 
macchine dedicate; il progetto javadb qui presenta- 
to vive invece all'interno del processo principale 
dell'applicazione. La realizzazione di un database 
relazionale non è affatto semplice e ci sono già pro- 
getti open source che hanno obbiettivi simili, ma so- 
no più avanti nello sviluppo lo scopo qui è piuttosto 
quello di affrontare problemi non banali e le relative 
soluzioni. I due elementi principali su cui si basa 
javadb sono il parser dei comandi, basato sulla clas- 
se StringTokenizer e la struttura a comandi, svilup- 
pata secondo il pattern Command. 



ELABORARE 
I COMANDI SQL 

Il parser implementato è abbastanza semplice e si 



Ciascuno di questi comandi, come noto ha una di- 
versa sintassi, che viene approfondita in classi co- 
mando specifiche; per capire quale di queste invo- 
care viene analizzato l'inizio del comando (DROP 
CREATE, INSERT): sostanzialmente il primo token 
della stringa. Se infatti si ha l'istruzione SQL: 

CREATE DATABASE Prova 

i token risultanti dall'elaborazione con StringToke- 
nizer sono: 

CREATE 

DATABASE 

Prova 

Il parser trova dunque i dati già scomposti e pronti 
per l'elaborazione, che avviene nella classe Com- 
mandPorser. 

public Object execute( String sql ) throws SQLException { 
ParserTokenìzer st = new ParserTokenizer( sql ); 
if( st.hasMoreTokensQ ) { 

String commandName = (String)st.nextToken(); 

commandName = commandName. toUpperCaseQ; 



n 




REQUISITI 



Conoscenze richieste 



- Nozioni base di Java 
■' e SQL 



. lava 2 SE 1.3 o 
superiore. 
SuCD:J2SE1.4.2 
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CommandsUtil.trace( commandName ); 

Class clazz = (Class)commands.get( commandName ); 

if( clazz == nuli ) { 

throw new SQLException( 

"Comando non supportato: " + commandName); } 

try{ 

Command command = createCommand( clazz ); 
command.execute( session, st ); 
return command. getResultQ; 
} catch( Exception ex ) { 
ex.printStackTraceQ; 
throw new SQLException("Impossibile eseguire il 

comando");} 
} return nuli; 



classe DropCommand; il metodo executeO verifica il 
secondo token del comando, cercando DATABASE o 
TABLE (attualmente non implementato): 

public class DropCommand implements Command { 
public void execute(Session session, ParserTokenizer st) 
throws SQLException { 

if( st.hasMoreTokensQ ) { 

String what = (String)st.nextToken(); 
CommandsUtil.trace( "::"+what ); 

if( "DATABASE".equals( what ) ) { 

dropDatabase( session, st.nextToken() ); 

} else if( "TABLE". equals( what ) ) {} 

} } 

} 



Crea teC ammanti 




SelectCommand 






/ 












DropCommand 




Inserì Command 





Fig. 1: Struttura a comandi 



Come si nota dal codice, in 
commandName viene me- 
morizzato il primo token del 
comando e viene cercato 
all'interno della mappa 
commands; se viene trovato, 
viene eseguita una istanzia- 
zione dinamica della classe 
collegata, su cui viene chia- 
mato il metodo executeO- Il risultato viene ottenuto 
invece con la chiamata al metodo getResultO- L'ini- 
zializzazione della mappa avviene attraverso il me- 
todo initO, che per ciascun comando specifica la 
classe che ne effettua la gestione: 



void init() { 


commands 


= new Hashl^ 


ap(); 


commands 


put( 


DROP", 


t. bigatti .javadb. commands. 
DropCommand. class); 


commands. put("CREATE" 


it. bigatti .javadb. commands. 








CreateCommand. class); 


commands 


put(' 


INSERT" 


it.bigatti.javadb. commands 
.InsertCommand. class); 


commands 


put(' 


SELECT" 


it.bigatti.javadb. commands 
.SelectCommand. class); 


//commands. put 


"DELETE 


, it.bigatti.javadb. commands 








.DeleteCommand. class); } 



Ciascun comando supportato dal programma è im- 
plementato da una classe specifica, che implementa 
l'interfaccia Command (Fig. 1): 

public interface Command { 
void execute(Session session, ParserTokenizer st) 

throws SQLException; 
Object getResult(); } 



CANCELLAZIONE 
DATABASE: DROP 

L'istruzione DROP DATABASE è implementata nella 



Ovviamente sarebbe opportuno, in una realizzazio- 
ne più completa, sollevare una eccezione nel caso l'i- 
struzione non sia della sintassi corretta. La cancella- 
zione del database viene effettuata dal metodo drop- 
Databasef), che implementa i seguenti passaggi: 

• determinazione del percorso del file dati; 

• cancellazione delle tabelle presenti nel database; 

• cancellazione del database. 

void dropDatabase( Session session, String name ) 

throws SQLException { 
name = CommandsUtil.normalizel\lame( name ); 
CommandsUtil.trace( ":: db="+name ); 
File databaseFile = new File(CommandsUtil.getDataPath() 
+ File.separator +name); 

if( IdatabaseFile.existsQ ) { 

throw new SQLException("II database " + name + " 

non esìste" );} 
String[] files = databaseFile. Iist(); 
for( int i=0; i<files.length; i + + ) { 

File file = new File( databaseFile, files[i] ); 

if( Ifile.deleteQ ) { 

throw new SQLException("Impossibile eliminare il 
database " + name +" ( impossibile eliminare " 

+ filesrj] + " )" );} } 

if( 'databaseFile. deleteQ ) { 

throw new SQLException("Impossibile eliminare il 

database " + name );} 
} 

I database e le tabelle vengono memorizzate in mo- 
do molto semplice sul file system, utilizzando una 
directory per ciascun database e due file per ciascu- 
na tabella. Ad esempio: 

~/ .javadb 

+ Prova 

Prodotti, data 

Prodott.struct 
+ System 

Users.data 
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Users.struct 
Grants.data 
Grants.struct 

La struttura delle tabelle viene memorizzata come 
oggetto serializzato, nel file con estensione struct. 
I dati della tabella sono memorizzati invece nel file 
con estensione .data. 



il nome, il tipo e la dimensione. Queste informazio- 
ni verranno poi memorizzate nella struttura della 
tabella e potranno essere utilizzate per pilotare le 
successive operazioni. Come accennato, la struttura 
del database viene memorizzata in un file serializza- 
to; il nome del file viene ottenuto dalle classi di mo- 
dello, che contengono i metadati a proposito dello 
schema del database. Dalla sessione corrente si ot- 
tiene il database a cui si è attualmente connessi: 




CREAZIONE 
DEL DATABASE 

L'istruzione di creazione delle tabelle e database è 
invece implementata nella classe CreateCommand. 
Il metodo createDatabaseQ, seguendo la logica di 
memorizzazione dei dati sopra esposta, non fa altro 
che creare la directory che ospiterà il database, con- 
trollando eventuali errori in fase di creazione, e che 
il database richiesto non esista già: 

void createDatabase( Session session, String name ) 

throws SQLException { 
name = CommandsUtil.normalizeName( name ); 
CommandsUtil.trace( ":: db="+name ); 
File databaseFile = new File(CommandsUtil.getDataPath() 
+ File.separator +name); 
if( databaseFile. exists() ) { 
throw new SQLException("II database " + name + " 

esiste già" );} 
if( !databaseFile.mkdirs() ) { 
throw new SQLException("Impossibile creare il 

database " + name );} 
session. setCurrentDatabase(new DatabaseData(name)); 
} 

Anche in questo caso eventuali errori sono segnala- 
ti come SQLException; in realtà, essendo ancora sul 
lato dell'implementazione interna del database e 
non a livello di interfacce JDBC, sarebbe stato op- 
portuno utilizzare un'eccezione personalizzata, co- 
me ad esempio DatabaseException, da convertire 
poi in una SQLException. In questo modo si sarebbe 
realizzata una maggiore divisione tra gli strati del- 
l'applicazione. 



CREAZIONE 

DI UNA TABELLA 

Le difficoltà che si incontrano nella creazione di una 
nuova tabella sono legate alla decodifica dell'istru- 
zione CREATE TABLE. Ad esempio: 

CREATE TABLE Prodotti (id int(ll) NOT NULL, 

nome varchar(lOO), valore number(13,5)) 

Ciascun campo deve essere analizzato per ottenerne 



DatabaseData databaseData = session. getCurrentDatabaseQ; 

poi è necessario creare un oggetto che rappresenti la 
tabella: 

TableData tableData = new TableData( name, fields, order); 

a questo punto sono disponibili tutte le informazio- 
ni per costruire il percorso del file da creare (p.e. 
-l.javadblProvalProdotti.struct): 

File tableFile = new File(CommandsUtil.getDataPath() + 
File.separator +databaseData.getFileName() + 
File.separator +tableData.getFileName()); 

l'oggetto TableData viene poi serializzato e scritto su 
disco: 

try { 

ObjectOutputStream out = new ObjectOutputStream( 
new FileOutputStream(tableFile)); 

out.writeObject( tableData ); 

out.closeQ; 
} catch( IOException ex ) { 

throw new SQLExceptionflmpossibile creare la tabella "+ex); } 

Al costruttore di TableData è stata passata la variabi- 
le fields, che contiene una mappa con i campi del 
database; per estrarre queste informazioni viene im- 
plementato un ciclo, che continua l'iterazione all'in- 
terno del comando SQL, utilizzando però una strin- 
ga di delimitatori personalizzata, che oltre agli spazi 
vuoti include le parentesi, in modo che token come 
int(ll) vengano ritornati come due elementi diversi: 
int e 11. Per sapere in ogni momento quale elemen- 
to è in fase di lettura, viene utilizzata la variabile 
fieldltem che contiene un valore numerico diverso 
per ogni elemento. Ad esempio: 



token = 


id 


int 


11 


NOT 


NULL 


item = 


1 


2 


3 


4 


5 



SQL 

SQL è il linguaggio 
standard per l'accesso 
ai database relazionali, 
supportato dai 
principali database 
server; sebbene esista 
uno standard (il più 
diffuso è ANSI-92) ogni 
produttore 
implementa una 
propria versione del 
linguaggio derivata da 
quella standard. 



Si noti che la clausola NOT NULL è opzionale e 
potrebbe non essere presente; il codice tiene in 
considerazione questo fatto ed eventualmente 
imposta fieldltem a FD_NONE, che è una costan- 
te che rappresenta lo stato iniziale (si noti che 
per ciascun elemento da leggere è presente una 
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HSQLDB 

Il database HSQL 
(rrttp://hsqldb.sourceforqe 
.net/ ) è un relazionale 
scritto in Java, dotato 
di driver JDBC che 
supporta un ricco 
subset delle specifiche 
ANSI-92; il JAR è pic- 
colo (circa 160KB) e 
può memorizzare i dati 
sia su file che in me- 
moria. HSQL è integra- 
bile nelle applicazioni, 
oppure può essere ese- 
guito come processo 
server; inoltre include 
un web server minima- 
le e strumenti di am- 
ministrazione. Il codice 
viene dichiarato come 
di qualità pronta per la 
produzione ed è utiliz- 
zato per la persistenza 
in diversi prodotti 
open source e commer- 
ciali. 
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Fig. 2: Metadati di javadb 



costante che inizia per FD_). 

while( st.hasMoreTokens() ) { 
String token = (String)st.nextToken(" \t\n\r\f()"); 
//toglie eventuali virgole rimaste appese al token 

if( token. endsWith(",") ) { 

token = token. substring(0,token.length()-l);} 
switch( fieldltem ) { 
/** 

...altro codice 

*/ 

case FDJMOIME: 

fields.put( currentField.name, currentField ); 
order.add( currentField ); 

fieldltem+ + ; 

break; 

case FD_NAME: 

currentField = new FieldDataQ; 
currentField.name = token; 

fieldltem++; 

break; 

case FD_TYPE: 

currentField. type = token; 

fieldltem = FD_SIZE; 

break; 

case FD_SIZE: 

currentField. size = token; 

fieldltem = FD_NOT; 

break; } } 

if( currentField != nuli ) { 
fields.put( currentField.name, currentField ); 
order.add( currentField ); } 



MODELLO 
INFORMATIVO 

In Fig. 2 è presente il modello che contiene le meta- 
informazioni sul database, e che è composto dalle 
classi DatabaseData, TableData e FieldData; queste 
mantengono, rispettivamente, le informazioni su 
uno specifico database, su una specifica tabella e su 
uno specifico campo. Per semplicità queste classi 
utilizzano attributi pubblici, ma in una 
versione più evoluta dovrebbero aderire 
alle specifiche Javabeans ed utilizzare 
getter e setter. L'oggetto DatabaseData 
mantiene il nome del database, ed offre 
un metodo per ottenere l'oggetto Ta- 
bleData relativo ad una tabella di cui è 
noto il nome. Questi oggetti vengono 
inoltre mantenuti in memoria, in una 
mappa: 



public 


class DatabaseData 


impleme 


nts Seria 


izable 


{ 


pub 


ic String 


name; 










Map 


tables = 


new HashMap(); 









public String getFileName() { 

return name; } 
public String toString() { 

return "DatabaseData = [name="+name+ 

", tables="+tables+"]";} 

public TableData getTable( String name ) throws 

SQLException { 
TableData tableData = (TableData)tables.get(name); 

if( tableData == nuli ) { 

tableData = loadTableData( name ); 
tables. put( name, tableData );} 
return tableData; } 
public TableData loadTableData( String name ) 

throws SQLException { 
TableData tableData = nuli; 

File tableFile = new File(CommandsUtil.getDataPath() 

+ File. separator+getFìleName() + File. separator+ 

TableData.getFileName(name)); 

try { 

ObjectlnputStream out = new ObjectInputStream( 
new FileInputStream( tableFile )); 

tableData = (TableData)out.readObjectQ; 

out.closeQ; 
} catch( ClassNotFoundExceptìon exl ) { 
throw new SQLException("Impossibile caricare 

la tabella " + exl ); 
} catch( IOException ex2 ) { 
throw new SQLException("Impossibile caricare 

la tabella " + ex2 ); } 

return tableData;}} 

Come si nota, la classe è serializzabile (implementa 
Serializable), in quanto è necessario poterla scrivere 
su disco; come gli altri oggetti del modello informa- 
tivo, implementa il metodo toStringO, in modo da 
rendere più agevole lo sviluppo e la ricerca degli 
errori: stampando l'oggetto, ad esempio con un 
System.out.printlnO, invece di un criptico hashCode 
si troverà una descrizione completa del contenuto 
dell'oggetto. 



TABELLE E CAMPI 

La classe TableData contiene, oltre al nome della ta- 
bella, l'elenco dei campi della stessa; inoltre, viene 
memorizzata una lista che elenca l'ordine naturale 
dei campi come sono indicati in fase di creazione. Il 
problema è che la mappa che contiene i campi non 
mantiene l'ordine di inserimento nella stessa: quan- 
do si richiede l'enumerazione delle chiavi, vengono 
ritornate in un ordine diverso da quello di inseri- 
mento. Se viene creata la tabella in questo modo: 

CREATE TABLE Prodotti (id int(ll) NOT NULL, 

nome varchar(lOO), valore number(13,5)) 

e poi ad esempio si esegue un comando come: 
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SELECT * FROM Prodotti 

I dati ritornati dovranno essere del tipo: 

| id | nome | valore | 

+ + + + 

| 1 | prodottol | 12 | 

| 2 | prodotto2 | 24 | 

+ + + + 

La classe TableData viene implementata in questo 
modo: 

public class TableData implements Serializable { 
//... altro codice 
public Iterator getFieldsInl\laturalOrder() { 

return order.iterator();} 
public List getFieldNames() { 
computeFieldNames(); 
return fìeldNames;} 
void computeFieldNames() { 
if( fieldNames == nuli ) { 
fieldNames = new Arrayl_ist( order.sizeQ ); 
Iterator iter = order.iterator(); 

while( iter.hasNextQ ) { 

FieldData fieldData = (FieldData)iter.nextQ; 

fieldNames. add( fieldData. name );}}} 
public String toString() { 

return "TableData = [name="+name+ 

", fields="+fields+"]";}} 

La classe FieldData include, oltre alle informazioni 
relative al nome, tipo e dimensione un metodo che 
ritorna la dimensione totale del campo. Si noti infat- 
ti che la dimensione in SQL può includere la preci- 
sione. Ad esempio: 

INT(10,5) 

In questo caso la dimensione totale del campo è 10 
(5 è il numero dei decimali) . Il metodo getSizeO ritor- 
na la dimensione totale del campo, cioè il numero di 
byte che verranno dedicati alla memorizzazione 
della colonna: 

public class FieldData implements Serializable { //... 
public int getSize() { 
int sizeValue = 0; 
//Prende solo la parte intera (dimensione totale 

del campo) 
String tempSize = size; 
int pos = tempSize. indexOf(","); 

if( pos >= ) { 

tempSize = tempSize. substring(0, pos);} 

try { 

sizeValue = Integer.parselnt( tempSize ); 
} catch( NumberFormatException ex ) {} 



return sizeValue;} } 



CONNESSIONI 
E PROVA 

Il punto di ingresso per operare con il database è 
l'oggetto Session, che rappresenta una sessione di 
operatività con la base dati; una nuova sessione è 
ottenibile da parte delle classi client tramite il meto- 
do Session.getlnstanceO, che non fa altro che ritorna- 
re un nuovo oggetto; ovviamente, una versione più 
evoluta dovrebbe implementare un qualche metodo 
di autenticazione, ad esempio tramite un metodo 
loginQ. La sessione mantiene il database corrente su 
cui si sta operando, che è impostato in automatico 
ad esempio dopo una CREATE DATABASE, oppure 
esplicitamente tramite una istruzione di CONNECT. 

public class Session { 

DatabaseData databaseData; 
long created; 

public SessionQ { 

created = System. currentTimeMillis(); 
setCurrentDatabase( new DatabaseData( "Prova" ) );} 
public void setCurrentDatabase( DatabaseData 

databaseData ) { 
this. databaseData = databaseData;} 
public DatabaseData getCurrentDatabase() { 

return databaseData;} 
public Object execute( String sql ) throws 

SQLException { 
CommandParser parser = 

CommandParser.getInstance( this ); 
return parser.execute( sql );} 
public static Session getlnstance() { 
return new Session();} 
} 

A questo punto è possibile eseguire le prime prove. 
Ad esempio, creando un nuovo database ed una 
nuova tabella: 

Session session = new SessionQ; 

session. execute("CREATE DATABASE Prova"); 

session. execute("CREATE TABLE Prodotti (id int(ll) 

NOT NULL, nome varchar(lOO), valore number(13,5))"); 



CONCLUSIONI 

In questa prima puntata abbiamo creato una prima 
infrastruttura per la creazione del nostro database, 
implementando le funzionalità di creazione di data- 
base e tabelle (anche se in forma minimale). Nel 
prossimo numero effettueremo inserimenti, selezio- 
ni e cancellazioni di dati nelle tabelle. 

Massimiliano Bigatti 
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Un framework Open Source per la costruzione di interfacce utente 

Grafica super in C++ 
con wxWidgets 

wxWidgets è un framework per lo sviluppo di software con interfaccia 
grafica in C++. Il vasto numero di classi e l'elevata portabilità fanno di 
questo pacchetto open source un prodotto di qualità. 




□ CD □ WEB 

EsempL WxWiclgets.zi/i 



^* 



'■•' :r 











Applicazione 
wx Ap p 








l 








Fin estra 
wxFra me 















Fig. 1: Principali compo- 
nenti di un'applicazione 
con interfaccia grafica. 
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REQUISITI 



Conoscenze richieste 



— Fondamenti di C++, 
| concetti base di 
elettronica. 



i 



Qualsiasi compilatore 
C++. Presente sul CD 
wxWidgets nella 
sezione OPEN SOURCE! 






Tempo di realizzazione 



Scrivere un buon software prevede spesso la 
realizzazione di un'interfaccia grafica efficien- 
te, l'implementazione di protocolli di rete o il 
supporto delle funzioni di stampa. Tra i vari fra- 
mework, che forniscono soluzioni già pronte per 
questi problemi, wxWidgets spicca per due grandi 
vantaggi. Oltre ad essere completamente gratuito ed 
open source vanta un livello di astrazione tale da 
consentire il porting immediato delle applicazioni 
verso ognuna delle piattaforme attualmente più dif- 
fuse. Esistono infatti versioni di wxWidgets per siste- 
mi Windows, Linux e Mac (per citare i più comuni). 
Basti pensare che talvolta, per convertire un'appli- 
cazione ben scritta, è sufficiente una semplice 
ricompilazione dei sorgenti con l'opportuna versio- 
ne del framework. 



STRUTTURA 

DI UN'APPLICAZIONE 

Gran parte del codice di wxWidgets è organizzato in 
classi relative ai vari elementi che servono a mettere 
insieme l'applicazione. Per esempio, un programma 
dotato di interfaccia grafica si costruisce con gli ele- 
menti che seguono (Fig. 1): 

• Un oggetto di applicazione 

• Un frame 

Per oggetto di applicazione si intende un'istanza 
della classe wxApp, che rappresenta l'applicazione 
stessa e contiene l'indispensabile per mettere su un 
programma. Nel codice scritto per wxWidgets non 
appare la procedura main, alla quale siamo abituati, 
quest'ultima infatti viene sostituita da una funzione 
membro di nome OnlnitQ. Se dunque deriviamo 
una classe da wxApp avremo bisogno di definirla: 

#include <wx/wx.h> 

class myApp : public wxApp 



{ 

public: 

virtual bool OnInit(); 

}; 

Onlnit è la funzione del programma che sarà esegui- 
ta per prima e che possiamo adoperare per svolgere 
alcune operazioni preliminari, come la creazione 
del frame grafico principale. 

IMPLEMENT_APP(myApp) 

bool myApp: :OnInit() 

{ 

wxFrame *MyFrame = new wxFrame(NULL, -1, argv[0]); 

MyFrame->Show(TRUE); 

SetTopWindow(My Frame); 

return TRUE; 

} 

Il richiamo alla macro IMPLEMENT_APP viene in- 
serito per informare wxWidgets dell'esistenza della 
classe myApp, così l'oggetto verrà allocato dinami- 
camente. Come premesso, Onlnit si occupa di crea- 
re frame. Un frame è una finestra che possiamo 
ridimensionare e posizionare a nostro piacimento. 
Il primo elemento passato al costruttore della classe 
wxFrame è un puntatore NULL relativo ad un'even- 
tuale finestra parent, che per ora non ci interessa. 
Segue un numero di identificazione, dove -1 indica 
un parametro di default. All'ultimo argomento sta il 
nome che sarà visualizzato nella barra del titolo del- 
la finestra, qui specificando argv[0] facciamo appa- 
rire quello che il programma avrà una volta compi- 
lato, con il suo path. Si tratta di un membro di wx- 
App e ripropone perfettamente l'omonimo argo- 
mento che di consueto riscontriamo nella procedu- 
ra main. In pochissime righe abbiamo scritto il 
nostro primo programma funzionante, congratula- 
zioni! È ancora scarno, ma possiamo abbellirlo con 
un pezzo di codice da piazzare dopo l'allocazione 
dell'oggetto wxFrame: 
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MyFrame->CreateStatusBar(); 
MyFrame->SetStatusText("Hello World!"); 

In questo modo aggiungiamo una barra di stato e vi 
facciamo apparire classico "Hello World!". Per 
compilare l'esempio è necessario specificare i file di 
libreria necessari, a tale proposito vi rimandiamo al 
materiale allegato all'articolo. 



me, affinché il frame sia inizializzato regolarmente. 
Di seguito, allochiamo un oggetto di tipo wxMenu e 
tramite la funzione membro Appendo aggiungiamo 
le varie voci. FILEOPEN, ABOUT e EXIT sono dei 
numeri impostati arbitrariamente che, come vedre- 
mo, serviranno ad identificare la selezione dell'uten- 
te nella fase di gestione degli eventi. Possiamo defi- 
nire questi valori ricorrendo ad un'enumerazione: 




PERSONALIZZIAMO 
IL FRAME 

Dopo avere scritto il primo programmino funzio- 
nante andiamo a creare qualcosa di più complesso. 
Ad esempio, potremmo aggiungere un menu per far 
accedere l'utente alle funzioni di caricamento e sal- 
vataggio file. In wxWidgets, le classi interessate allo 
scopo sono wxMenu e wxMenuBar. La prima per- 
mette di costruire i singoli menu (es: il menu "File" 
con le voci "Carica", "Salva", "Esci", etc), l'altra inve- 
ce si occupa di raggrupparli per formare la barra di 
menu vera e propria, che sarà resa accessibile nella 
parte superiore della finestra. Per inserire questi due 
nuovi elementi abbiamo bisogno di derivare una 
nuova classe da wxFrame: 

class myFrame : public wxFrame 
{ public: 

myFrame(const wxString& titolo); 

~myFrame(); 
private: 

wxMenuBar *mMenuBar; 

wxMenu *mFileMenu; 

}; 

Derivando da wxFrame abbiamo la possibilità di 
costruire un frame personalizzato, inserendo le 
componenti che ci interessano, in questo caso quel- 
le necessarie alla realizzazione del menu. Dopo, la 
sua creazione può essere effettuata tramite il 
costruttore della classe myFrame: 

myFrame: :myFrame(const wxString& titolo) 

: wxFrame((wxFrame *) NULL, -1, titolo) 

{ // Creiamo il menu 

mFileMenu = new wxMenu; 

mFileMenu->Append(FILEOPEN, "&Open File"); 

mFileMenu->Append(ABOUT, "&About"); 

mFileMenu->Append(EXIT, "&Exit"); 

mMenuBar = new wxMenuBar; 

// Lo aggiungiamo alla barra 

mMenuBar->Append(mFileMenu, "&File"); 

// Visualizziamo la barra 

SetMenuBar(mMenuBar); 

} 

Per prima cosa invochiamo il costruttore di wxFra- 



enum { 

FILEOPEN = 100, 

ABOUT = 200, 

EXIT = 300 

}; 

In fine allochiamo l'oggetto di tipo wxMenuBar ed in 
un modo molto simile inseriamo il menu creato in 
precedenza. Richiamando la funzione SetMenu- 
Bar() rendiamo visibile la barra di menu. 



GESTIONE 
DEGLI EVENTI 

Il menu che abbiamo creato funziona ma non è 
ancora pienamente operativo, infatti, alla selezione 
di una determinata voce non segue alcuna azione. 
Occorre occuparsi della gestione degli eventi. In 
genere, si parla del verificarsi di un evento quando 
avviene qualcosa all'interno o all'esterno di un'ap- 
plicazione. Nel nostro caso, quando l'utente selezio- 
nerà una voce dal menu che abbiamo creato, 
seguirà il presentarsi di un apposito evento che 
avvertirà dell'accaduto. Tale procedimento in 
wxWidgets si gestisce con delle tabelle, adoperate 
per associare una funzione membro della classe a 
ciascun evento in modo che, quando questo si sarà 
verificato, sia eseguita la giusta porzione di codice. 
Il lettore vedrà subito quanto è semplice nella prati- 
ca. Sappiamo che tramite la funzione Appendo di 
wxMenu è possibile associare un numero di identifi- 
cazione ad ogni voce del menu. Questo numero è lo 
stesso che impiegheremo per costruire la tabella 
degli eventi: 

BEGIN_EVENT_TABLE (myFrame, wxFrame) 

EVT_MENU (FILEOPEN, myFrame: :OnFileOpen) 

EVT_MENU (ABOUT, myFrame: :OnAbout) 

EVT_MENU (EXIT, myFrame: :OnExit) 

END_EVENT_TABLE() 

Il tutto si realizza ricorrendo ad un insieme di macro. 
BEGIN_EVENT_TABLEO segna l'inizio della tabella; 
tra i suoi argomenti troviamo il nome della nostra 
classe myFrame e quello della classe dalla quale è 
stata derivata, cioè wxFrame. Adoperiamo poi 
EVT_MENU() per inserire i vari elementi, in questo 
caso indichiamo a wxWidgets quale funzione mem- 



SVILUPPO A 
COSTO ZERO 

È possibile scrivere 
applicazioni per 
wxWidgets 
adoperando come 
ambiente di sviluppo il 
noto IDE open source 
Dev-C++ prodotto da 
Bloodsheed. Nel CD è 
presente il materiale 
necessario per 
l'integrazione dei due 
package. Per 
informazioni 
http://www.wxwi ndow 
s.org/devcpp.htm 
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02^B 

wxWidgets si adatta a 
stile e aspetto grafico 

tipici del sistema per il 

quale l'applicazione è 

stata scritta. 




Fig. 2: Un messaggio di 
about. 



bro della classe va associata al verificarsi di eventi 
relativi all'uso del menu: è sufficiente specificare il 
numero di codice dell'evento e il nome della funzio- 
ne che desideriamo assegnare. La myFrame diven- 
terà poi: 

class myFrame : public wxFrame 
{ // Costrutti! re 

void OnFileOpen(wxCommandEvent& event); 
void OnAbout(wxCommandEvent& event); 
void OnExit(wxCommandEvent& event); 

protected : 

DECLARE_EVENT_TABLE() 

}; 

Il membro della classe, che tramite EVT_MENU as- 
sociamo di volta in volta all'evento, è una funzione 
void che ha per argomento un oggetto del tipo wx- 
CommandEvent, contenente informazioni sull'e- 
vento. Infine, la chiamata alla macro DECLARE_ 
EVENT_TABLEO va inserita all'interno di myFrame. 
Ora che sappiamo come associare il codice al verifi- 
carsi degli eventi occupiamoci dei casi più semplici. 
Partiamo con il più elementare, cioè la selezione 
della voce "Exit" che segna la fine del programma. È 
sufficiente una chiamata alla funzione CloseO: si 
trova già nella classe, essendo stata ereditata da 
wxFrame che ne dispone: 

void myFrame: :OnExit(wxCommandEvent& event) 

{ Close(TRUE); 

} 

Non appena l'utente selezionerà la voce "Exit" dal 
menu sarà eseguita in automatico la funzione 
OnExit ed il programma verrà chiuso. 



FINESTRE 
DIALOGO 



Cogliamo la palla al balzo per aprire un utile paren- 
tesi circa le finestre di dialogo. Ad esempio vogliamo 
fare in modo che, selezionando la voce "About" dal 
menu, il programma sia momentaneamente sospe- 
so ed appaia una finestra contenente alcune infor- 
mazioni sul copyright, oppure il nome degli autori 
(Fig. 2). Per scopi come questo wxWidgets offre un 
ricco insieme di common dialog. Non andremo a 
scriverci personalmente i dialog necessari alle varie 
evenienze poiché i programmatori hanno già pensa- 
to di rendere disponibili quelli per le circostanze più 
comuni, sotto forma di classi pronte all'uso. Per la 
nostra finestra di about, infatti, è sufficiente adope- 
rare la classe wxMessageDialog, com'è possibile 
vedere nel codice che segue. Il tutto si risolve in 



poche righe: 

void myFrame: :OnAbout(wxCommandEvent& event) 
{ wxMessageDialog aboutDlg(this, 

"ioProgrammo production 2004", 

"About...", wxOK); 

aboutDIg.ShowModalQ; } 

OnAbout è il nome della funzione che, tramite la 
tabella degli eventi, abbiamo precedentemente 
destinato allo scopo. Nella prima riga ci limitiamo 
ad istanziare un oggetto di tipo wxMessageDialog. 
Qualche riga sopra abbiamo visto che, quando si 
crea un nuovo frame, è possibile specificare una 
finestra parent (genitore) al fine di stabilire una 
gerarchia. Trattandosi allora del frame principale 
questo dettaglio non ci interessava ed abbiamo 
messo NULL, indicando così l'assenza di una fine- 
stra di livello superiore. Stavolta la situazione è diffe- 
rente poiché possiamo imporre che la finestra 
parent del nuovo dialog sia proprio il frame princi- 
pale dell'applicazione. A tale scopo passiamo pun- 
tatore this al primo argomento del costruttore. 
Seguono il testo del messaggio vero e proprio da 
visualizzare, il titolo da dare alla finestra che lo con- 
terrà ed il tipo di pulsanti che intendiamo far appa- 
rire: wxOK indica un pulsante con su scritto "Ok", 
un'altra possibile scelta è wxCANCEL. E' consentito 
visualizzarli entrambi con un'operazione di Or, in 
C++ si scrive: wxOK | wxCANCEL. Inoltre, Show- 
Modal() visualizza il dialog completo restituendo 
come valore di ritorno un numero relativo a quella 
che è stata la selezione dell'utente. Se l'utente ha 
cliccato il tasto "Ok" la funzione restituisce wxID_ 
OK, altre possibilità sono wxID_CANCEL, wxID_ 
YES: dipende da quali pulsanti si è scelto di visualiz- 
zare. Un altro interessante dialog che esaminiamo in 
questo articolo è quello adottato per la selezione dei 
file, la classe interessata si chiama wxFileDialog. 
Immaginiamo di voler far apparire una finestra di 
tale genere dopo la selezione della voce "Open File" 
del menu. Scriveremo: 

void myFrame: :OnFileOpen(wxCommandEvent& event) 
{ // Allochiamo l'oggetto 

wxFileDialog *openFileDialog = new wxFileDialog 

(this, "Open file", "", "", "*.*" , wxOPEN, 
wxDefaultPosition); 
// Visualizziamo il dialog 

if (openFileDialog->ShowModal() == wxID_OK) 
// Prendiamo nome e path del file 
SetFilel\lame(openFileDialog->GetFilename(), 

open FileDia log- >GetDirectory()); 
} 

Alla selezione della voce "Open File" del menu 
segue l'esecuzione della funzione qui proposta. 
Essa in primo luogo alloca un oggetto di tipo 
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wxFileDialog deputato alla creazione di una fine- 
stra di dialogo per la selezione di files. Nel costrut- 
tore vanno specificati l'indirizzo della finestra 
parent (dunque passiamo this, come visto sopra) 
ed un messaggio di titolo, seguono due stringhe 
volte a indicare rispettivamente una directory ed 
un Alenarne di default (entrambe possono essere 
vuote, come infatti sono). Dunque, si passa un fil- 
tro per i nomi di file (es: *.* oppure *.txt) qui defi- 
nito tramite una stringa. E' possibile specificare 
più filtri, ciò è utile se ad esempio vi è la necessita 
di lavorare con più tipi di file, come nel caso di 
software per l'elaborazione di immagini che offro- 
no supporto per i vari formati bitmap, jpeg, gif, etc. 
Questo si attua tramite una sintassi molto sempli- 
ce: per ogni elemento si specifica una descrizione 
del tipo di file seguita da un simbolo "|" cui proce- 
de il filtro vero e proprio. Per esempio: 

wxChar *FILTRI = „T("Bitmap|*.bmp|" 

"JPEG|*.jpg;*.jpeg|""GIF|*.gif"); 

Anche se divisa in più parti per ragioni di como- 
dità, si tratta comunque di un'unica stringa dato 
che, in C++, le stringhe adiacenti vengono conca- 
tenate automaticamente durante la fase di compi- 
lazione. Il punto e virgola si adopera quando un 
tipo di file può presentare differenti estensioni, ciò 
si verifica in diverse circostanze come nel caso dei 
file html o dei sorgenti C++ (.cpp, .ce, etc). L'ulti- 
mo argomento stabilisce lo stile della finestra, a 
seconda che si tratti di un dialog di apertura o di 
salvataggio dei Ale: si tratta di un valore di tipo 
long, qui scriviamo wxOPEN. Come per la finestra 
di about, il dialog viene visualizzato tramite una 
chiamata alla funzione ShowModalO che restitui- 
sce wxID_OK in caso di successo. L'oggetto contie- 
ne poi il nome del file selezionato ed il suo path 
che si ricavano invocando i suoi membri Get- 
Filename() e GetDirectoryO. SetFileName è una 
funzione membro della nostra classe myFrame e 
serve a memorizzare in un oggetto stringa il nome 
del file completo del suo path, in modo da ricor- 
darlo se poi lo si dovrà considerare nuovamente, 
ad esempio per effettuare un salvataggio. 



PROGRAMMIAMO 
UHI IUOTEPAD 

Sappiamo lavorare con le principali classi di 
wxWidgets, conosciamo come gestire gli eventi ed 
alcuni common dialog, abbiamo tutte le carte in 
regola per scrivere il nostro primo programma 
completo. Per concludere questo articolo di intro- 
duzione realizzeremo un semplice editor in stile 
notepad, con funzioni di caricamento, salvataggio 
e modifica dei normali file di testo. Qualcuno 



potrebbe pensare che si tratti di un'operazione 
complicata gestire un file di testo, caricarlo in 
memoria, occuparsi della corretta visualizzazione 
dei caratteri e dei vari elementi di input, ma non è 
così. Fortunatamente wxWidgets, in modo simile a 
MFC, offre un insieme di controlli che svolgono in 
modo semplice e trasparente anche le funzioni 
che sarebbe più tedioso programmare. Un con- 
trollo è, in genere, una piccola finestra che serve a 
visualizzare un insieme di dati tenendo conto del- 
l'input. Il controllo wxTextCtrl si presta perfetta- 
mente al nostro scopo, ci permette addirittura di 
caricare e salvare file di testo senza saper nulla del 
sistema di file adoperato da wxWidgets. Tale mera- 
viglia si concretizza inserendo un'unica riga di 
codice nel costruttore della classe myFrame: 

mTextCtrl = new wxTextCtrl(this, -1, wxString("Nessun 

file caricato"), wxDefaultPosition, wxDefaultSize, 

wxTE_MULTILINE); 

mTextCtrl è un membro che abbiamo aggiunto a 
myFrame, si tratta di un puntatore ad un oggetto di 
tipo wxTextCtrl. Adesso andiamo a parlare del suo 
costruttore. Innanzitutto abbiamo bisogno che la 
finestra, dove verrà visualizzato il testo vero e pro- 
prio, sia contenuta dentro il nostro frame principa- 
le, dunque ancora una volta, specifichiamo il pun- 
tatore this; -1 indica il solito parametro di default, 
la stringa successiva contiene il testo che da princi- 
pio sarà visualizzato sullo schermo. Attenzione, 
nessun file da editare è ancora stato caricato. 
wxDefaltPosition e wxDefaultSize sono dei para- 
metri che indicano una posizione ed una dimen- 
sione standard, infine wxTE_MULTILINE fa in 
modo che la finestra sia volta a contenere un testo 
disposto su più righe. Non resta che caricare il file 
mediante la funzione LoadFileQ di wxTextCtrl: 

mTextCtrl- >LoadFile(*mFileName); 

mFileName è il puntatore alla stringa che contiene 
il nome del file, che abbiamo inserito tramite la 
funzione SetFileName (), di cui si è parlato sopra. Il 
salvataggio si effettua in modo analogo tramite 
funzione SaveFile(). Ora disponete di un editor di 
testi funzionante! 



CONCLUSIONI 

Abbiamo preso in esame alcune delle caratteristi- 
che fondamentali illustrando una via semplice per 
familiarizzare con questo framework dalle molte 
possibilità. Invitiamo il lettore ad approfondire 
l'argomento consultando i sorgenti allegati e visi- 
tando il sito di wxWidgets. Buon lavoro! 

Andrea Ingegneri 




SITO WEB 

È possibile scaricare 
versioni più 
aggiornate di 
wxWidgets dal sito 

www.wxwidqets.org 



LICENZA 

La licenza di 
wxWidgets 2 permette 
lo sviluppo di 
applicazioni sia 
proprietarie sia open 
source, le sue 
condizioni sono valide 
per scopi personali, 
accademici o 
commerciali. 
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Le procedure per la gestione di un PC in Rete 

Controllo 
remoto in VB 



(parte ultima) 



In questo numero realizzeremo una funzione di chat e daremo 
la possibilità di condividere risorse. Due funzioni fondamentali 
per gestire da remoto un PC. 




□ CD □ WEB 

RemoteControl.zip 



^ 



EuEEm 



-p» REQUISITI 



Conoscenze richieste 



— Conoscenze 
t-J di base di Visual Basic 



Windows 

98/ME/2000/XP/2003, 
Visual Basic 6.0 




In quest'ultima puntata termineremo il discorso 
iniziato un paio di mesi fa, analizzando la restan- 
te parte del codice implementato. Analogamen- 
te alle precedenti puntate, avremo modo di vedere 
alcune API di Windows molto interessanti e mostre- 
remo alla fine un esempio che ci consente di redire- 
zionare l'output di una finestra DOS verso un con- 
trollo di tipo TextBox. 



A PROPOSITO 
DI MOUSE 

La volta scorsa abbiamo lasciato il discorso a metà, 
mostrando semplicemente i primi pulsanti di que- 
sta sezione. Vediamo quindi anche i restanti, comin- 
ciando da quello che consente di impostare a 
distanza le coordinate del mouse. La pressione del 
pulsante cmdMousePos non fa altro che provocare 
l'invio, al server, del messaggio SETMPOS che lo 
processerà, come al solito, attraverso la procedura 
ClientRequestf). Naturalmente, il messaggio SETM- 
POS deve essere seguito da due parametri che rap- 
presentano le coordinate alle quali confinare il cur- 
sore del mouse. La tipica stringa inviata al server 
sarà del tipo: 



"SETMPOS;" & txtMouseX.Text & ' 



' & txtMouseY.Text 



Affinché esso possa "esaudire" tale richiesta, viene 
invocata un'API di Windows denominata SetCursor- 
PosO così dichiarata: 

Declare Function SetCursorPos Lib "user32" Alias 

"SetCursorPos" (ByVal x As Long, ByVal y As Long) 

As Long 

A questo punto, non è certamente difficile desume- 
re quale sarà il comando invocato dal server, ossia: 



SetCursorPos ClientRequestSplit(l), ClientRequestSplit(2) 

Il successivo pulsante di questo pannello permette 
di effettuare il logoff della sessione corrente. Il mes- 
saggio inviato dal client è, come visto nella prece- 
dente puntata, LOGOFE II server, anche questa 
volta, si serve di un'API di Windows per effettuare 
quest'operazione, denominata ExitWindowsEx ()■ La 
sintassi di questa funzione è la seguente: 

Declare Function ExitWindowsEx Lib "user32" Alias 

"ExitWindowsEx" (ByVal uFIags As Long, ByVal 
dwReserved As Long) As Long 

Il primo parametro è quello più importante ed iden- 
tifica il tipo di "shutdown" che si vuole effettuare. 
Esistono diverse costanti utili allo scopo e sono uti- 
lizzabili in varie combinazioni, consentendo di 
effettuare un restart, uno shutdown, un logoff, ecc. 
Per i nostri scopi è sufficiente sfruttare la costante 
EWX_ LOGOFF (che assume valore 0) , impostando il 
secondo parametro dwReserved al medesimo valo- 
re. Il successivo CommandButton è quello che si 
occupa di disabilitare o abilitare la sequenza di tasti 
CTRL+ALT+CANC. A seconda del tipo d'operazione 
che deve essere compiuta, la parte client del proget- 
to invia un messaggio ENABLE o DISABLE per indi- 
care al server l'abilitazione o la disabilitazione di 
questa funzionalità. Dal lato server il tutto si traduce 
nell'uso di un'altra API, denominata SystemParame- 
tersInfoO- Questa funzione consente di ottenere in- 
formazioni o impostare alcuni parametri relativi 
all'intero sistema. Il suo uso, per alcuni aspetti, è 
piuttosto complesso poiché coinvolge moltissime 
costanti ed impostazioni del sistema. La sintassi di 
SystemParametersInfoO è la seguente: 

Declare Function SystemParametersInfo Lib "user32" 

Alias "SystemParametersInfoA" (ByVal uAction As Long, 
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ByVal uParam As Long, ByVal IpvParam As Any, ByVal 
fuWinlni As Long) As Long 

In particolare, primo parametro identifica l'impo- 
stazione sulla quale ottenere informazioni o da 
reimpostare. I restanti, invece, dipendono dal primo 
e dall'operazione che si sta compiendo. Poiché sa- 
rebbe troppo lungo entrare nel merito, vedremo 
semplicemente l'istruzione che consente di ottene- 
re quanto vogliamo: 

SystemParametersInfo(97,Flag,CStr(l),0) 

dove Flagpuò assumere valore True o False a secon- 
da se decidiamo di abilitare o meno questa funzio- 
nalità. 



LA COIUDIVISIOIUE 
DELLE RISORSE 

Siamo finalmente giunti all'ultimo pulsante di que- 
sta sezione, il tasto Share. La pressione di questo pul- 
sante permette di condividere una risorsa sul com- 
puter remoto. Dal momento che l'operazione che si 
vuole compiere non è molto semplice, per i tanti 
aspetti che la contraddistinguono, si è preferito crea- 
re sul server un modulo a parte, distinto dal Gene- 
rale.bas, ove "confinare" tutte le funzioni, le proce- 
dure e le strutture utili allo scopo. Il nome del modu- 
lo è Share.bas e contiene molto di più di quanto sia 
stato realmente utilizzato all'interno del progetto (in 
particolare, mi riferisco alla parte riguardante la 
dichiarazione delle strutture e delle costanti utili ad 
alcune API di Windows) .Per cominciare, comunque, 
ecco la stringa che il client invia al server alla pres- 
sione del pulsante Share: 

"SHARE;" & txtPathShare.Text & ";" & txtNomeShare.Text 

Il primo parametro indica il percorso della risorsa da 
condividere, mentre il secondo rappresenta il nome 
che assumerà la risorsa condivisa. Il server gestisce 
questo particolare messaggio servendosi della solita 
procedura ClientRequestO '. Una volta riconosciuto il 
messaggio, invoca immediatamente la funzione 
MakeShareQ, inviando al seguito un codice di rispo- 
sta al client che lo avvertirà circa l'esito dell'opera- 
zione. La funzione MakeShareQ è così definita: 



Public 


Function MakeShare(PathOfShare As Stri 
NameOfShare As String) 


ng, 

As 


Long 


Dim 


SI502 As SHARE_INFO_502 








Dim 


SI50 As SHARE_INFO_50 








Dim 


OSVERInfo As OSVERSIONINFO 








Dim 


ShareComment As String 








Dim 


CodErr As Long 








Dim 


pwd As String 









Dim ret As Long 

'Impostiamo il commento e la password della risorsa 
ShareComment="Remote Share - IoProgrammo" 

pwd="RCl" 

If OSVERInfo. dwPlatformId = l Then 

'Se Windows 9x... 
SI50.shi50_netname= NameOfShare 

SI50.shi50_path = PathOfShare 

SI50.shi50_remark=ShareComment 

SI50,shi50_type=STYPE_DISKTREE 

SI50.shi50_ro_password=vbNullChar 
SI50.shi50_rw_password=vbNullChar 

CodErr=NetShareAdd9x(0&, 50, SI50, ret) 

Else 

'... altrimenti 

SI502.shi502_current_uses=0 

SI502.shi502_max_uses= 10 

SI502.shi502_netname=StrConv(NameOfShare, 

vbUnicode) 
SI502.shi502_passwd=StrConv(pwd, vbUnicode) 
SI502.shi502_path=StrConv(PathOfShare, 

vbUnicode) 

SI502.shi502_permissions=ACCESS_ALL 

SI502.shi502_remark=StrConv(ShareComment, 

vbUnicode) 

SI502.shi502_reserved=0 

SI502.shi502_security_descriptor=Security 

SI502.shi502_type=STYPE_DISKTREE 

CodErr=NetShareAddNT(Q&, 2, SI502, ret) 

End If 

MakeShare=CodErr 
End Function 

Gli unici parametri accettati dalla funzione sono 
PathOfShare e NameOf- 
Share (che ovviamente ri- 
specchiano proprio i due 
dati che il client passa al 
server al momento della 
richiesta) e restituisce il 
valore zero in caso d'esito 
positivo. All'inizio della 
funzione, vengono di- 
chiarate due variabili 
"struttura" denominate 
rispettivamente SI502 ed 
SI50. Esse rispecchiano le 
seguenti due strutture: 




s 




Jip 



Fig. 1: La condivisione della directory C:\WinXP. 



Public Type SHARE_INFO_502 

shi502_netname As String 
shi502_type As Long 
shi502_remark As String 
shi502_permissions As Long 
shi502_max_uses As Long 
shi502_current_uses As Long 
shi502_path As String 
shi502_passwd As String 
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shi502_ 


_reserved As 


Long 






shi502_ 


_security_descriptor As 

SECURITY_ 


J3ESCRIPTOR 


End 


Type 













HilSliJ 


- Chat - 




C: Ciao 




S: Ciao 




C: Come slai? 




S: Bene e tu? 




|| Elene e tu? 


|; "trivi*:: ;| 



Fig. 2: La finestra Chat (lato server). 



Questa la seconda struttura: 

Type SHARE_INFO_50 

shi50_netname As String 

shi50_type As String 

shi50_flags As Long 

shi50_remark As String 

shi50_path As String 

shi50_rw_password As String 

shi50_ro_password As String 
End Type 

Come potrete facilmen- 
te intuire, queste due 
strutture serviranno da 
"base dati" per alcuni 
funzioni appartenenti 
alle API di Windows. In 
particolare, le due varia- 
bili ShareComment e 
pwd, valorizzate all'ini- 
zio della funzione, con- 
sentono d'impostare ri- 
spettivamente, un commento e la password d'ac- 
cesso della risorsa che si sta per condividere. Detta- 
gli a parte, il punto fondamentale del codice relativo 
a MakeShareO, è innanzitutto l'identificazione del 
sistema operativo avviato sull'host/server poiché 
sarà questo a determinare l'utilizzo di una delle due 
strutture precedenti. Per far questo, la funzione Ma- 
keShareO si serve dell'API GetVersionExQ la cui sin- 
tassi è: 

Declare Function GetVersionEx Lib "kernel32" Alias 

"GetVersionExA" (ByVal IpVersionlnformation 
As OSVERSIONINFO) As Long 

L'unico parametro accettato, IpVersionlnformation, 
come si può osservare, è una variabile di tipo OS- 
VERSIONINFO, una struttura in grado di ritornare 
diverse informazioni a riguardo. Essa risulta così 
definita: 



Public Type OSVERSIONINFO 


dwOSVersionlnfoSize As 


Long 


dwMajorVersion As Long 


dwMinorVersìon As Long 


dwBuildNumber As Long 


dwPlatformld As Long 


szCSDVersion As String * 


128 


End Type 



In particolare, MakeShareO si preoccupa di control- 



lare l'item dwPlattformld. Esso può assumere diver- 
si valori che condizioneranno il comportamento 
successivo della funzione. Infatti, nel caso valore 
ritornato sia pari ad uno, vene riempita opportuna- 
mente la struttura SI50 dichiarata in testa alla fun- 
zione, altrimenti viene valorizzata la SI502. Esiste 
anche la possibilità (remota. . .) che si tratti di siste- 
mi operativi Windows For Workgroup. In tal caso, la 
GetVersionExQ ritornerebbe, come valore dell'item 
dwPlatformld, il valore zero. A questo punto, appu- 
rato il tipo di sistema operativo, la funzione Make- 
ShareO opera alcune scelte. Nel caso dwPlatformld 
risulti essere pari ad uno, verrà sfruttata la NetSha- 
reAdd9xO così dichiarata: 

Public Declare Function NetShareAdd9x Lib "svrapi.dll" 

Alias "NetShareAdd" (ByVal servername As Any, 

ByVal slevel As Long, buf As SHARE_INFO_50, 

ByVal cbbuf As Long) As Long 

che opererà sulla struttura SI50 precedentemente 
valorizzata. Nel caso dwPlatformld sia, invece, di- 
verso da uno, sfrutterà TAPI NetShareAddNTQ la cui 
sintassi risulta essere praticamente la stessa, fatta 
eccezione per il terzo parametro, buf, che non è più 
una struttura SHARE_INFO_50, ma SHARE_INFO_ 
502: 

Public Declare Function NetShareAddNT Lib "netapi32.dll" 
Alias "NetShareAdd" (ByVal servername As Any, ByVal 
slevel As Long, buf As SHARE_INFO_502, ByVal cbbuf 

As Long) As Long 

Il valore di ritorno di entrambe queste funzioni, 
qualunque sia quella utilizzata, verrà quindi sfrutta- 
to da MakeShareO per informare il client circa l'esi- 
to dell'operazione, permettendogli di mostrare a vi- 
deo il corretto messaggio. 



LA SEZIONE CHAT 

La sezione Chat è probabilmente la sezione più 
semplice che sia stata implementata all'interno del 
programma. Attraverso essa, infatti, il client avverte 
il server circa l'intenzione di avviare una sessione di 
questo genere ed esso, riconosciuto il messaggio, 
mostra a video un'apposita finestra utile a tale col- 
loquio. Quando il client decide di avviare una ses- 
sione di chat, invia al server un messaggio AVVIO 
attraverso il controllo WinsockChat, sulla porta defi- 
nita da PORT_RC+l. Il server, a questo punto, riceve 
la richiesta attraverso l'evento DataArrìvalO del'o- 
monimo controllo WinsockChat, che è così definito: 

Private Sub WinsockChat_DataArrival(ByVal bytesTotal 

As Long) 
WinsockChat. GetData RispostaChat, vbString 
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Select Case RispostaChat 

Case "AVVIO": 

frmChat.Show 

EventLogChat.Addltem "Inizio sessione Chat" 

Exit Sub 

Case "CLOSE": 

Unload frmChat 

EventLogChat.Addltem "Fine sessione Chat" 
Exit Sub 
End Select 

frmChat.txtChat.Text=frmChat.txtChat.Text+vbCrLf 

+ "C: "+RispostaChat 
End Sub 

Per prima cosa, mostra a video la form frmChat, poi 
aggiorna successivamente il controllo EventLogChat 
con la stringa Inizio sessione Chat, dando inizio allo 
scambio d'informazioni. In particolare, si osservi 
che esso riconosce semplicemente due tipi di mes- 
saggi ossia AVVIO (per iniziare la sessione) e CLOSE 
(per terminarla). Tutto quello che riceve e non equi- 
vale a nessuno di questi due prefissi, viene conside- 
rato come un messaggio della chat e viene accodato 
ai precedenti attraverso l'ultima istruzione. Essa, in 
particolare, antepone ad ogni messaggio, la stringa 
"C: " che consente di distinguere un messaggio del 
server da quello del client. Analogamente a quanto 
accade per il server, un suo messaggio, viene "cattu- 
rato dall'evento DataArrivalO del controllo Winsock- 
Chat. Il codice che implementa le funzionalità di 
chat, lato client, è molto più semplice e simile a 
quanto visto precedentemente. 

Private Sub WinsockChat_DataArrival(ByVal bytesTotal 

As Long) 
"Acquisisce la risposta dal server e 
Ma memorizza in RispostaChat 
WinsockChat.GetData RispostaChat, vbString 
txtChat.Text=txtChat.Text+vbCrLf+"S: "+RispostaChat 
End Sub 

Anch'esso, ad ogni messaggio ricevuto, antepone 
una "S: " (che permette di distinguerlo dai messaggi 
inviati) e l'accoda ai restanti contenuti all'interno 
della TextBox txtChat. Contrariamente a quanto 
visto nella parte server, non è stato previsto un mes- 
saggio di tipo CLOSEper consentire al server d'inter- 
rompere la sessione di chat. Ovviamente, questa è 
solo una "personale" convenzione e chiunque può 
decidere di variarla modificando il codice poc'anzi 
presentato affinché riconosca e gestisca tale mes- 
saggio. 



LA SEZIONE 
EXPLORER 

Siamo giunti finalmente all'ultima sezione, denomi- 



nata Explorer. In questa sezione sono state raccolte 
alcune informazioni importanti circa sistema ser- 
ver al quale ci si è connessi ed in particolare: 

• Nome del PC; 

• Directory corrente; 

• Elenco di alcune variabili d'ambiente (OS, TEMI! 
USERNAME, CPU Identìfler e CPU Level). 




Fig. 3: La finestra Chat (lato client). 



Ovviamente, questa se- 
zione poteva essere mol- 
to più complessa e com- 
pleta allo stesso tempo e 
poteva includere qualun- 
que tipo d'informazione. 
Tuttavia, semplicemente 
per non appesantire 
troppo il codice presen- 
tato, si è preferito mo- 
strare solo qualche esem- 
pio, lasciando che gli in- 
teressati modifichino il 
codice a proprio deside- 
rio. Con la pressione del 

pulsante cmdSezExplorer viene inviato al server un 
messaggio INFO. Il server processerà questa richie- 
sta attraverso la "solita" ClientRequestQ e demanderà 
il compito di gestirla alla procedura Invialnforma- 
zioniO contenuta all'interno del modulo Genera- 
le.bas. Essa risulta così strutturata: 

Public Sub InviaInformazioni() 
Dim BufLen As Long 
Dim StrTemp As String 
Dim Datalnfo As String 

'Inizializza Datalnfo che, a procedura ultimata 
Verrà inviata al socket client 

DataInfo="INFO;" 

'— Nome PC 

"Crea il buffer 

BufLen = MAX_COM PUTERNAM E_LENGTH + 1 

StrTemp=String(BufLen,"X") 
"Ottieni il nome del PC 

GetComputerName StrTemp, BufLen 
'get only the actual data 

StrTemp=Left(StrTemp,BufLen) 
"Aggiorna Datalnfo 

DataInfo=DataInfo+StrTemp+";" 

'— Directoy corrente 

"Crea il buffer 

StrTemp=String(255,0) 

Yetrieve the current directory 

GetCurrentDirectory 255, StrTemp 
"Aggiorna Datalnfo 

DataInfo=DataInfo+StrTemp+";" 
'— Elenco di alcune variabili di ambiente 

StrTemp=String(255,0) 

StrTemp=Environ$("OS") 





^^^^^™ 


Uscita 




3 


C: Ciao 
S: Ciao 
C: Come stai? 
S: Bene e tu? 


j 
j 


Come slai? 


Invia | Chiudi | 


H 


Server Chat FTP 
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DataInfo = DataInfo+StrTemp+";" 

StrTemp=Environ$("USERNAME") 

DataInfo = DataInfo+StrTemp+";" 

StrTemp=Environ$("TEMP") 

DataInfo = DataInfo+StrTemp+";" 
StrTemp=Environ$("PROCESSOR_IDENTIFIER") 
DataInfo = DataInfo+StrTemp+";" 
StrTemp=Environ$("PROCESSOR_LEVEL") 
DataInfo = DataInfo+StrTemp 
frmServer.WinsockServer.SendData Datalnfo 
End Sub 



Mairi. lblCPUIdentifier.Caption=ServerRequestSplit(6) 

'Variabile ambiente CPU LEVEL 

Main.lblCPULevel.Caption=ServerRequestSplit(7) 

Inutile sottolineare il significato di queste istruzioni 
poiché credo sia chiaro a tutti. Naturalmente, una 
sezione di questo tipo, analogamente a quella deno- 
minata Varie, si presta molto bene ad ulteriori 
modifiche ed ampliamenti poiché il "raggio d'azio- 
ne" è davvero molto ampio. 







PTP 



Fig. 4: La sezione Explorer. 



Per ritornare le informa- 
zioni al client, ancora 
una volta, viene sfruttato 
il sistema d'inviare un'u- 
nica stringa in cui ogni 
"valore" è separato da un 
";". Innanzitutto, quindi, 
viene preparato il prefis- 
so di tale messaggio, 
rappresentato dalla va- 
riabile stringa Datalnfo 
ed inizializzato con il va- 
lore "INFO;". Successi- 
vamente ha inizio la rile- 
vazione della prima in- 
formazione ossia nome del PC. Essa è ottenuta 
attraverso l'uso dell'API GetComputerNameQ e ri- 
posta nella variabile temporanea StrTemp. Ad ese- 
cuzione ultimata, tale stringa è accodata a Datalnfo 
e "terminata" con il solito ";". Il passo seguente è 
quello di rilevare la directory di lavoro corrente. In- 
vialnformazioniO si serve di GetCurrentDirectoryO 
per raggiungere tale scopo e, analogamente a quan- 
to visto in precedenza, accoda l'informazione a Da- 
talnfo. Il processo va avanti anche per i successivi 
dati, riguardanti le informazioni su alcune variabili 
d'ambiente. L'ultimo dato, quello relativo alla varia- 
bile d'ambiente PROCESSOR_LEVEL, è accodato a 
Datalnfo senza che sia terminata con il solito ";" ed 
inviata al client attraverso il metodo SendData del 
controllo WinsockServer. Al ricevimento di un mes- 
saggio con prefisso INFO, la procedura ServerRe- 
questQ del modulo client, provoca una serie di sem- 
plici azioni, riassunte di seguite: 

'Nome PC 

Main.lblNomePC.Caption=ServerRequestSplit(l) 

'Directory corrente 

Main.lblCurrDir.Caption=ServerRequestSplit(2) 
'Variabile ambiente OS 

Main.lblSO.Caption=ServerRequestSplit(3) 
'Variabile ambiente USERNAME 

Main.lblUsername.Caption = ServerRequestSplit(4) 
'Variabile ambiente TEMP 

Main.lblVarTEMP.Caption=ServerRequestSplit(5) 

'Variabile ambiente CPU IDENTIFIER 



ALCUNI 
SUGGERIMENTI 

Inutile dire che il programma appena mostrato, 
avendo uno scopo "didattico", non è certamente 
completo, né tantomeno vuole esserlo. Tuttavia, 
prima di lasciarvi, mi preme evidenziare una "pic- 
cola" routine che vi consentirà di migliorarlo ancor 
di più. Essa è stata prelevata direttamente da 
Internet e potete utilizzarla come meglio credete. 
Prima di mostrarvela, volevo solo evidenziare un 
piccolo particolare del programma presentato (lato 
server) che non è stato reso evidente sinora. Se ana- 
lizzate bene il codice implementato, vi accorgerete 
della presenza di un controllo Timer sulla form prin- 
cipale. 

L'evento TimerQ legato ad esso possiede al suo in- 
terno le seguenti istruzioni: 

Private Sub Timerl_Timer() 

Dim Pt As POINTAPI 

Dim HandleWin As Long 

'Preleva le coordinate correnti del mouse 

GetCursorPos Pt 

'Handle della finestra sotto il mouse 

HandleWin=WindowFromPoint(Pt.X, Pt.Y) 

End Sub 

Attraverso queste semplici linee di codice, potete 
venire a conoscenza, in qualunque momento, delle 
coordinate correnti del mouse e, soprattutto, otte- 
nere l'handle della finestra sulla quale si trova at- 
tualmente il cursore. Queste informazioni, special- 
mente la seconda, sono molto interessanti e vi con- 
sentiranno d'implementare qualunque tipo d'azio- 
ne sfruttando la miriade di API che vogliono, neces- 
sariamente, tra i loro parametri, un handle. Natural- 
mente lascio ad ognuno di voi il compito di sfrutta- 
re quanto appena detto e sono certo che ne saprete 
trarre il giusto beneficio. Abbiamo visto che il pro- 
gramma è in grado di avviare applicazioni ed allo 
stesso tempo possiamo anche inviare file modifi- 
cando opportunamente alcune parti del codice im- 
plementato, con particolare riferimento alla funzio- 
ne SendFileO- 

Francesco Lippo 
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I trucchi del mestiere 

Tips & Tricks 

Questa rubrica raccoglie trucchi e piccoli pezzi di codice che solitamente non trovano posto nei manuali, frutto 
dell'esperienza di chi programma. Alcuni di essi sono proposti dalla redazione, altri provengono da una ricerca su 
internet, altri ancora ci giungono dai lettori. Chi vuole contribuire potrà inviarci i suoi Tips&Tricks preferiti. Una volta 
selezzionati, saranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\o 
sul Web all'indirizzo: cdrom.ioprogrammo.it. 




VISUAL 
BASIC 



COMBOBOX COI\l ELEMENTI 
UNIVOCI 

Un semplice fa funzionale modulo per non avere nelle Combo- 
Box parole e frasi ripetute. 

Tip fornito dal sig. B.Croce 

Public Function Doppioni(Parola As String, NomeOggetto As 

ComboBox) As String 

ce = 

For doppio = To (NomeOggetto. ListCount) 

If Trim(UCase(NomeOggetto.List(doppio))) Like UCase( 

Trim(Parola)) Then 

ce = 1 

Exit Function 




CREARE UNA DIRECTORY 
AL VOLO 

Un utilissimo tip che mostra come creare al volo una cartella di 
sistema. La funzione CreateFolder di tipo booleano richiede un 
solo parametro di tipo tinga che corrisponde al percoso della car- 
tella da creare. Un esempio può essere c:\innoland. Il valore di 
ritorno è un booleano ed è True se la directory viene creata e False 



1 IL TIP DEL MESE 

DA TESTO A PDF 

Di seguito è mostrato come richiamare correttamente la proce- 
dura: ConvertToPDF "Esempio.txt", "Esempio.pdf, "AutoreEsem- 
pioTXT", "CreatoreEsempioTXT", "KeyWordTXT", "OggettoTXT", 
"TitoloTXT", "Courier", 90, 11, 8. Tutti i parametri esclusi i primi 
due non sono obbligatori. Gli ultimi tre campi rappresentano la: 
Rotazione (90,180,270 o 360), Larghezza e Altezza in pollici. 
Questo comando fa parte della classe TXTToPDF.bas che, trova- 
te in versione integrale presente nel CD-Rom allegato alla rivista 
e sul sito web di ioProgrammo {www.ioprogrammo.it). 
Di seguito è riportata la sola procedura ConvertToPDF. 

Tip fornito dal sig. ABracci 

Public Sub ConvertToPDF(filename As String, outputfile As String, 

Optional TextAuthor As String, Optional TextCreator As String, 

Optional TextKeywords As String, Optional TextSubject As String, 

Optional TextTitle As String, Optional FontName As String = 

"Courier", Optional FontSize As Integer = 10, Optional Rotation 

As Integer, Optional pwidth As Single = 8.5, Optional pheight 

As Single = 11) 



On Error GoTo er 

If Not FileExists(filename) Then 

MsgBox "File '" & filename & "' does not exist." 

Exit Sub 
Elself FileExists(outputfile) Then 

Kill outputfile 

End If 

Initialize FontName, FontSize, Rotation, pwidth, pheight 
author = TextAuthor 
creator = TextCreator 
keywords = TextKeywords 
subject = TextSubject 

Title = TextTitle 

filetxt = filename 
filepdf = outputfile 

Cali WriteStart 

Cali WriteHead 

Cali WritePages 

Cali EndPDF 



MsgBox Err.Description 
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se vi son stati dei problemi. Il try-catch è stato messo apposta per 
evitare degli errori e consentire il ritorno del parametro. 

Tip fornito dal sig. ACarratta 

Public Function CreateFolder(ByVal FolderPath As String) As Boolean 
'Script creato da Carratta Andrea aka innovatel 
'Sito Web: www.innoland.it 
'EMail: innoland@innoland.it 
Dim bIResult As Boolean = False 

If (FolderPath.Trim <> "") Then 

Try 

Dim Folder As System. IO. Directorylnfo 

Folder = New System. IO. Directorylnfo(FolderPath) 

If Not (Folder.Exists) Then 

Folder.Create() 
bIResult = True 

End If 

Catch 

bIResult = False 

End Try 

End If 

Return bIResult 

End Function 



UHI REPORT GRAFICO 
PER LE APPLICAZIONI 

Alcune applicazioni necessitano, dopo aver elaborato un cer- 
to numero e tipo di dati, di mostrare i risultati ottenuti con 
l'ausilio di controlli ad alto impatto visivo come i grafici. Esi- 
stono numerosi controlli di terze parti che offrono la possibi- 
lità di risolvere questo problema ma, con le possibilità che il 
Framework .NET ci offre, è possibile creare questi controlli 
personalmente. La procedura allegata, sviluppata in Visual 
Basic .NET consente la creazione di un controllo per la crea- 
zione di semplici grafici, con la possibilià di inserire etichette 
per ogni punto del grafico, scelta dei colori delle linee, zoom 
in/out, etc... 

Il codiceVB.NET è presente nel CD-Rom allegato alla rivista 
e sul web {www.ioprogrammo.it) . 

Tip fornito dal sig. PLibro 




JAVA 



"ALBERI" PERSONALIZZATI 

Di seguito viene proposto un modo per utilizzare delle immagini 
personalizzate negli alberi in Java Swing. Bisogna estendere la 
classe dei nodi DefaultMutableTreeNode per aggiungere un para- 
metro per memorizzare l'indirizzo dell'immagine. (Classe No- 
dolcon nell'esempio). Successivamente, è necessario estendere la 
classe che si occupa di disegnare le immagini ' DefaultTreeCell- 
Renderer', per visualizzare le nuove immagini (Classe IconeAlbero 
nell'esempio). Infine, basta utilizzare i nuovi nodi ed impostare la 
nuova classe che si occuperà di disegnare le immagini {Classe 
Swing nell'esempio). Il codice sorgente è presente nel CD-Rom 



allegato alla rivista e sul web {www.ioprogrammo.it). 

Tip fornito dal sig. G.Orsini 

FILE IconeAlbero 

import javax. swing. tree.DefaultTreeCelIRenderer; 

import javax. swing. Imagelcon; 

import java.awt.Component; 

import javax. swing. JTree; 

public class IconeAlbero extends DefaultTreeCelIRenderer 

{ //Implementazione metodo 

public Component getTreeCellRendererComponent(JTree tree, 

Object value, boolean sei, boolean expanded, boolean leaf,int row, 

boolean hasFocus) 
{ //Richiesta a superclasse 

super.getTreeCellRendererComponent(tree, value, sei, 

expanded, leaf, row, hasFocus); 
//Recupera i dati dell'icona 
Nodolcon nodo = (Nodolcon)value; 
Imagelcon imglcona; 
//Carica l'icona richiesta 
imglcona = new Imagelcon (nodo. getIcon()); 
//Verifica l'esistenza dell'icona e la carica 
if(imgIcona! = null) 
setlcon(imglcona); 
//Restituisce l'oggetto 
return this; }} 
FILE Swing 
import java.awt.*; 
import javax. swing.*; 
public class Swing extends JFrame 
{ public Swing() 

{ //Swing di esempio 
//Pannello principale 

final JPanel pan = (JPanel)getContentPane(); 
//Lista immagini 

String radice= "Icone/Radice. gif"; 
String nodol = "Icone/Nodo 1. gif"; 
String nodo2="Icone/Nodo2.gif"; 
String foglia 1 = "Icone/Fogliai. gif"; 
String foglia2="Icone/Fog Iia2.gif"; 
String foglia3 = "Icone/Fog Iia3.gif"; 
//Definizione nodi 

Nodolcon A = new NodoIcon("Radice", radice); 
Nodolcon B = new NodoIcon("Nodo A",nodol); 
Nodolcon C = new NodoIcon("Nodo B",nodo2); 
//Definizione foglie 

C.add(new NodoIcon("Foglia Bl",foglia3)); 
C.add(new NodoIcon("Foglia B2",foglia3)); 
B.add(new NodoIcon("Foglia Al", fogliai)); 
B.add(new NodoIcon("Foglia A2",foglia2)); 

B.add(C); 

B.add(new NodoIcon("Foglia A3", fogliai)); 
B.add(new NodoIcon("Foglia A4",foglia2)); 
//Unione nodi a radice 

A.add(B); 

//Preparazione albero 

final JTree albero = new JTree(A); 

//Impostazione disegno albero 
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albero.setCellRenderer(new IconeAlbero()); 
//Preparazione finestra 

setSize(200,300); 

setTitle("Albero"); 

pan.setLayout(new BorderLayout()); 
//Aggiunta albero a finestra 
pan. add(albero,Borderl_ayout. CENTER); 
//Gestione chiusura finestra 

setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); } 

//Inizio 

public static void main(String[]arg) 
{ //Definizione e avvio finestra prova 
Swing f=new Swing(); 

f.showQ; }} 

FILE IModoIcon 

import javax. swing. tree.DefaultMutableTreeNode; 
public class Nodolcon extends DefaultMutableTreeNode 
{ private String icona; 
//Costruttore con specifica icona 
public NodoIcon(String testo, String pathlcona) 

_J 

super( testo); 
icona = pathlcona;} 
//Restituisce l'icona attuale del nodo 
public String getIcon() 
{ return icona; } 
//Imposta l'icona del nodo 
public void setIcon(String pathlcona) 
{ icona = pathIcona;} 
} 

COME "ZIPPARE" 
UMA DIRECTORY 

Attraverso il package java, util.zip, Java fornisce alcuni semplici 
meccanismi per comprimere e decomprimere file. Il metodo 
zipDir mostra come comprimere ricorsivamente un albero di 
directory. Il metodo accetta un oggetto String come directory da 
comprimere e un oggetto ZipOutputStream che rappresenta il file 
compresso. Il metodo zipDir non include le directory vuote nel- 
l'archivio zip creato. 

tryj 

ZipOutputStream zos = new 

ZipOutputStream(newFileOutputStream(". \\curDir.zip")); 

zipDir(".\\inFolder", zos); 

zos.close(); } 

catch(Exception e) {} 

public void zipDir(String dir2zip, ZipOutputStream zos) 

{try 

{ zipDir = new File(dir2zip); 

String[] dirList = zipDir.listfJ; 

byte[] readBuffer = new byte[2156]; 

int bytesln = 0; 

forfjnt i=0; i<dirList.length; i++) 
{ File f = new File(zipDir, dirList[i]); 
if(f.isDirectory()) 
{ String filePath = f.getPathQ; 



zipDir(filePath, zos); 
continue; 

} 

FilelnputStream fis = new FilelnputStream(f); 
ZipEntry anEntry = new ZipEntry(f.getPath()); 
zos. putNextEntry(an Entry); 
while((bytesln = fis.read(readBuffer)) != -1) 

{ 

zos.write(readBuffer, 0, bytesln); 

} 

fis.close(); 

} 

} 

catch(Exception e) 

{ 

} 




DELPHI 



ESEGUIRE APPLICAZIONI 
ALL'AVVIO DI WINDOWS 

Utile funzione per far si che un'applicazione sia eseguita all'av- 
vio di Windows subito dopo l'installazione di un particolare 
pacchetto. 

procedure RunOnStartup(sProgTitle, sCmdLine : string; 

bRunOnce : boolean ); 
var 
sKey : string; 
reg : TReglniFile; 
begin 
if( bRunOnce )then 

sKey := 'Once' 
else 

sKey := "; 
reg := TregIniFile.Create( " ); 
reg.RootKey:= HKEY_LOCAL_MACHINE; 
reg.WriteString( 
'SoftwareMicrosoft' 
+ 'WindowsCurrentVersionRun' 
+ sKey + #0, 
sProgTitle, 
sCmdLine); 
reg.Free; 
end; 



INSERIRE UN FILE JPEG 
IN UN ESEGUIBILE 

Includere un'immagine JPEG nell'eseguibile di un'applicazione è 
molto semplice, basta utilizzare i file di risorse e il compilatore di 
risorse Borland (a riga di comando). Con un editor di testi (No te- 
pad) create un file di risorse e aggiungete la riga RODATA "Pic.jpg" 
salvate file appena creato come MyPic.RC e compilatelo con il 
Borland Resource Compiler 
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BRCC32 MyPic.RC 

Il compilatore creerà il file MyPic.RES, a questo punto aggiungete 
la direttiva per il compilatore nel sorgente del vostro programma 
subito dopo la direttiva per il form. 

{$R *.DFM> 

{$R MyPic.RES} 

Ecco il codice da inserire nell'applicazione. 

procedure LoadJPEGfromEXE; 

var 

MyJPG : TJPEGImage; 

ResStream : TResourceStream; 
begin 
try 

MyJPG := TJPEGImage. Create; 

ResStream := TResourceStream. CreateFromID(HInstance, 1, 

RT_RCDATA); 

MyJPG. LoadFromStream( ResStream); 

Canvas.Draw(12, 12, MyJPG); 

finally 

MyJPG. Free; 

ResStream. Free; 
end; 
end; 



begin 

if(QueryServiceStatus(schs, ss)) then 
begin 

while(SERVICE_RUNI\IING oss.dwCurrentState) do 
begin 

dwChkP := ss.dwCheckPoint; 
Sleep(ss.dwWaitHint); 
if(not QueryServiceStatus(schs,ss)) then 
begin 
break; 
end; 

if(ss.dwCheckPoint < dwChkP) then 
begin 
break; 
end; 
end; 
end; 
end; 

CloseServiceHandle(schs); 
end; 

CloseServiceHandle(schm); 
end; 

Result := SERVICE_RUNI\IING = ss.dwCurrentState; 
end; 



AVVIARE SERVIZI WINDOWS 

In alcuni casi è indispensabile arrestare o avviare servizi, anche 
remoti, per evitare conflitti con qualche applicazione in esecu- 
zione. Il codice seguente mostra come avviare e arrestare servizi 
in un sistema Windows. 



uses WinSvc; 

// avvia il servizio e restituisce TRUE se l'operazione è andata a buon fine 
// sMachine: nome della macchina, esempio: \SERVER 
// empty = macchina locale 
// sService nome del servizio, esempio: Alerter 
function ServiceStart(sMachine, sService : string ) : boolean; 
var 
schm, 

schs : SC_Handle; 
ss : TServiceStatus; 
psTemp : PChar; 
dwChkP : DWord; 
begin 
ss.dwCurrentState := -1; 

sch := OpenSCManager( PChar(sMachine), Nil, SC_MANAGER_CONNECT); 
if(schm > 0)then 
begin 
schs := OpenService(schm, PChar(sService), SERVICE_START or 
SERVICE_QUERY_STATUS); 
if(schs > 0)then 
begin 
psTemp := Nil; 
if(StartService(schs, 0, psTemp)) then 
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Ancora un colpo messo a segno dagli hacker contro Microsoft 

Internet Explorer KO! 

Gli hackers realizzano una tripletta di exploit nel giro di un mese, in grado 
di mandare in crash il browser Internet Explorer. Un tre-a-zero secco che 
costringe Microsoft ad accelerare il rilascio delle ultime patch di sicurezza. 
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Fig. 1: Uno dei tanti 
crash di Internet 
Explorer che è possibile 
provocare usando gli 
exploit e i codici HTML 
descritti in queste 
pagine. 



Girando in rete alla ricerca di nuovi bug e nuovi 
exploit da testare sulla mia macchina Windows, 
mi sono imbattuto in un sito molto curioso, 
aperto da poco tempo da un hacker che si fa chiamare 
"Liu Die Yu", specializzato nello studio dei problemi di 
sicurezza nel mondo Windows. Il sito in questione è 
raggiungibile all'indirizzo http://www.iebug.com ed è 
una sorta di catalogatore automatico degli advisory di 
sicurezza, dei bug e degli exploit scoperti ogni giorno in 
merito ai seguenti prodotti Microsoft: Internet Explo- 
rer, Outlook e Windows Media. In sostanza, esiste una 
sorta di robot, programmato dal creatore del sito, che 
scansiona periodicamente le mailing list di sicurezza 
cercando qualsiasi bollettino riguardante i prodotti 
Microsoft citati, per poi segnarlo e catalogarlo sulla 
pagina indicata. Proprio spulciando tra le numerose 
righe apparse di recente su IEBUG.COM, ho seleziona- 
to tre diversi bug di Internet Explorer, in grado di man- 
dare in crash (in maniera molto elementare) il browser 
di Microsoft con errori molto strani. Al momento si trat- 
ta di tre exploit in grado soltanto di crashare IE e causa- 
re qualche fastidio (anche perché l'attacco può essere 
integrato nei messaggi di posta tramite Outlook 
Express), ma non è escluso che in futuro qualcuno di 
questi exploit non possa tramutarsi in qualcosa di più 
pericoloso, ammesso che qualche hacker riesca a capi- 
re come controllare i registri di memoria sovrascritti in 
seguito al crash di Internet Explorer. 
Deviando dal consueto quindi, in questo 
numero di ioProgrammo studieremo 
questi tre diversi metodi che permettono 
di mandare crash IE, discutendo del 
contesto di applicazione degli exploit e 
degli effetti per ciascuno di questi. 



L'EVENTO onLoad 

Il primo dei tre bug riguarda il metodo onLoad presen- 
te nel linguaggio HTML ed è un errore riportato da un 
hacker chiamato cipher attraverso il suo sito 
www.cipher.org.uk/index.php?p=cipher/advisories.ciph 
er. Chi mastica un pò di HTML, sa che all'interno del 
tag <BODY> di una pagina web è possibile inserire la 
proprietà onLoad, che permette di specificare uno 



script iniziale che verrà eseguito all'atto del caricamen- 
to della pagina. La combinazione del metodo urin- 
dow.location all'interno della proprietà onLoad, unita 
all'uso di alcuni codici speciali, riesce a crashare IE con 
un errore applicativo che forza la chiusura del browser 
e si sviluppa fino alla libreria di sistema USER32.DLL, 
passando attraverso URLMON e MSHTML. Il metodo 
window. location è uno dei tanti modi usati per specifi- 
care l'indirizzo di una pagina web e cambiare l'uri cor- 
rente con quello di una nuova locazione; l'uso impro- 
prio di questo metodo causa non pochi problemi ad IE 
ed avviene quando invece di specificare un indirizzo 
del tipo window. location = http://www.miosito.com, si 
usa un link che punta ad un file locale, nella forma win- 
dow.location =flle:/lc:\mioflle. Se al posto del drive "c:\" 
viene specificato un qualsiasi altro nome di drive utiliz- 
zando la codifica esadecimale (ad esempio \xff:\ miofl- 
lé), Internet Explorer va in tilt e termina con un errore 
imprevisto nel tentativo di localizzare il file su un drive 
imprecisato. 

<html> 

<body onLoad Javascript: window. location = 

"file://\xff:\autoexec.bat";> 

IE CRASH-TEST NR 1 (onLoad) 

</html> 

Analizzando l'errore a livello di debug, fino a scendere 
nel codice assembly delle librerie crashate, si può nota- 
re come, a seguito del crash, vengano sovrascritti i tre 
registri ECX, EDX e EDI. Lo scopritore di questa vulne- 
rabilità fa notare che tramite il nome di drive malfor- 
mato è possibile controllare i primi 16 bit di EDX e EDI, 
esiste quindi una remota possibilità di tramutare que- 
sto crash in qualcosa di più pericoloso, come l'esecu- 
zione di codice remoto (è necessario però approfondi- 
re e confermare questa ipotesi). In questi casi il proble- 
ma più grosso per gli hacker è trovare un modo per 
pilotare l'esecuzione delle istruzioni e iniettare nello 
stack dove avviene il crash le proprie istruzioni che 
mirano a forzare la sicurezza del sistema. Vista la natu- 
ra dell'exploit, realizzabile con una semplice riga del tag 
<BODY>, può essere usato in qualsiasi render HTML 
che faccia uso delle librerie di IE, come ad esempio 
MSN Messenger oppure Outlook Express. 
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UHI PICCOLO KILLER 
IH! JAVASCRIPT 

Il secondo bug di IE presentato è una scoperta di Mike 
Mauler ed è anch'esso un errore abbastanza strano da 
osservare. Nel messaggio http://seclists.org/lists/fldldisclo- 
surel2004IMayl0757.html postato sulla mailing list flill- 
disclosure, viene osservato lo strano comportamento 
del browser Microsoft in presenza del seguente Java- 
script: 



<html> 


< seri pt ty pe = "text/ja vascri pt" > 


Wnd = wìndow.createPopupO; 


Wnd.document.body.innerHTML= 
http-equiv="imagetoolbar" 


'<meta 
content="no">'; 


</script> 


IE CRASH-TEST NR 2 (Javascript) 


</html> 



L'oggetto coinvolto è il solito "popup" di IE, che manda 
in crash il browser nel momento in cui lo script prova 
ad usare la proprietà . innerHTML (già da diverso tempo 
oggetto di molte altre vulnerabilità, ndr) nel modo illu- 
strato poc'anzi. Anche in questo caso, come nell'exploit 
precedente, IE termina in modo imprevisto e va in 
crash con un errore applicativo nella libreria MSHTML. 
DLL. A differenza del bug precedente però, sembra che 
in questo caso non sia possibile prendere il controllo di 
alcun registro, perché l'errore è dovuto ad un banale 
null-pointer presente nel codice di IE. Da un lato que- 
sto ci rassicura e ci fa pensare che anche i programma- 
tori di Microsoft devono combattere con i puntatori 
nulli (con scarsi risultati!) nel loro lavoro quotidiano. 
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Fig. 2: II crash causato dall'exploit in Javascript è 
dovuto ad una referenza incosistente (null-pointer) 
presente nel codice del browser di Microsoft. 



UniQ "STILE" CHE 
PUÒ COSTARE CARO! 

Infine l'ultimo bug da segnalare interessa i fogli di stile, 
ovvero i famosi file .CSS, utilizzati dai web editor per 
uniformare l'aspetto delle pagine web e migliorare la 
visibilità di font e colori. Lo scopritore di ques'ultimo 
"caso di crash"ha pubblicato una demo del codice incri- 
minato, testabile all'indirizzo http://www.zeepost.nl/ 
~henkielindex.html. In questo caso l'errore scaturisce 
dall'uso dei fogli di stile in un punto non usuale delle 
pagine HTML: sembra che la chiamata ad un CSS inse- 
rita in prossimità dei tag di tabelle e di form {<TABLE> 
e <FORM>), provochi il crash indesiderato, dovuto 
quasi sicuramente ad un errore di parsing della libreria 



MSHTML.DLL. La pagina web che causa il crash di IE è 
la seguente: 

<table> 

<td> 

<form class="quick"> 

<td> 

</form> 

</table> 

<link rel = "stylesheet" href= 

"http://www.zeepost.nl/~henkie/link.css"> 
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La parte critica del codice è quella riferita al tag <LINK>, 
dove si richiama il foglio di stile LINK .CSS, che deve 
risultare esterno rispetto alla pagina e contiene una 
semplice riga .quick {float: left;}. Nell'esempio abbiamo 
utilizzato un collegamento che punta allo stesso foglio 
di stile usato dallo scopritore della vulnerbabilità. La 
cosa più allarmante di quest'ultimo bug è il fatto che 
non dipende da script malformati, di conseguenza 
mentre per i primi due exploit è possibile limitare i 
danni attivando le restrizioni massime di sicurezza di IE 
(quelle che disabilitano gli script, per capirci), in que- 
st'ultimo caso non si può fare a meno di subire il crash. 
Ancora non è stata condotta nessuna indagine sul bug 
in questione e non si è studiata la possibilità di sfrutta- 
re l'errore per eseguire codice remoto. 



CONCLUSIONI 

Abbiamo presentato tre exploit per Internet Explorer, di 
cui ancora non esiste una patch ufficiale e che funzio- 
nano con successo perfino sulle ultimissime versioni 
del browser, anche quelle dotate del ServicePackl e con 
tutte le patch di sicurezza del momento. E' d'obbligo 
sottolineare il fatto che i tre exploit possono essere ri- 
condotti facilmente anche in altre applicazioni Micro- 
soft che fanno uso delle stesse librerie di parsing HTML 
di IE, come ad esempio Outlook Express, MSN Messen- 
ger^ Windows Media Player. A titolo di prova abbiamo 
provato a realizzare una mail malformata, che inte- 
grando uno degli exploit presentati, è in grado di cra- 
share Outlook Express nel momento in cui viene rice- 
vuta e visualizzata. 

Elio Florio 



Fig. 3: Seguendo il crash 
in modalità debug è 
possibile discendere nei 
meandri del codice 
assembly di IE, 
scoprendo magari se è 
possibile controllare i 
registri del processore e 
il flusso delle isruzioni. 
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Costruiamo un automa capace di mu oversi 

Un robot che corre 

La realizzazione di un dispositivo meccanico non è né complessa, 
né costosa. Vediamo come sia possibile realizzarlo in un'ora di 
tempo e con meno di venti euro. 
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Lj CD Lj WEB 

Base_Robot.zip 
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Fig. 1: La base robotizzata è in grado di trasportare un 
carico utile di alcuni kilogrammi. 




REQUISITI 



n.u.wmij, 



9 Fondamenti di C++, 
concetti base 
di elettronica 



Windows 

95/98/ME/2000/NT/XP 
Borland C++ 4.0 o 
superiore 



f^r^^a 



Tempo di realizzazione 



0000 



Srso la metà degli anni settanta, nell'indu- 
stria, accadde un evento che condizionò de- 
cisamente le strategie produttive di ogni ciclo 
di assemblaggio: in quel periodo avvenne il sorpas- 
so tra il costo orario di un addetto e quello di un 
robot industriale. Andando oltre le considerazioni di 
carattere sociologico nel mondo industrializzato, 
questo evento ha portato ad una progressiva mag- 
giore diffusione dei robot industriali. Lungi dal vole- 
re descrivere le caratteristiche di una di queste mac- 
chine, lo scopo che ci prefiggiamo in questa sede è 
di costruire un semplice robottino mobile, che emu- 
lando i fratelli maggiori, utilizzati per trasportare 
pesi di quintali e talvolta tonnellate, deambulano in 
modo preciso ed ordinato in molte industrie. Il no- 
stro robottino avrà in 
ogni modo caratteristi- 
che meccaniche di tutto 
rispetto, sarà in grado di 
trasportare pesi di alcuni 
kilogrammi, con una pre- 
cisione di navigazione 
dell' 1% , significando con 
questo che durante il suo 
movimento, l'errore di 
posizione massimo sarà 
pari ali 1% della distanza 
percorsa. Volendo dare 
una definizione più accurata della realizzazione, 
possiamo affermare che intendiamo progettare e 
costruire una base mobile azionata da ruote secon- 
do la tecnica della trazione differenziale (differenticd 
drive) a tre gradi di libertà. Le dimensioni del robot- 
tino potranno essere variate secondo le necessità 
dell'utente, noi abbiamo realizzato una base mobile 
di 20 cm di lato: il software presentato in questa sede 
permette comunque di gestire applicazioni di 
dimensioni differenti. Al termine di questo articolo 
sarà presentato un programma di gestione della 
base robotizzata, in grado di controllare qualunque 
tipo di robot mobile a trazione differenziale. 
Un'ultima importante specifica, che spero faccia 
contenti i molti studenti che mi scrivono, è il costo 
di realizzazione, che non dovrà superare i venti euro. 




Fig. 2: Questo mese la Elisys s.r.l. offre in omaggio i 
componenti per realizzare il robottino a chi acquista un 
sistema PC Explorer tight. 



IL PRINCIPIO 

DI FUNZIONAMENTO 

Il movimento del robot sul piano viene ottenuto per 
mezzo della trazione differenziale delle due ruote 
motrici. Per garantire il massimo della semplicità 
della applicazione, come stabilito nelle specifiche 
iniziali, si è deciso di rendere possibile l'avanzamen- 
to dei motori soltanto in avanti: l'implementazione 
del controllo avanti-indietro su ciascun asse può es- 
sere sviluppato successivamente, impiegando siste- 
mi di controllo senz'altro più complessi di quelli che 
vengono proposti in questa sede. Il controllo della 
mobilità della macchina avviene quindi semplice- 
mente controllando la commutazione fermo/ avan- 
ti di ciascun motore: quando entrambi i motori sa- 
ranno fermi, il robot risulterà fermo, mentre quando 
entrambi ruotano in avanti la macchina procederà 
in avanti. Per ottenere la sterzata della nostra picco- 
la realizzazione, è sufficiente azionare il motore cor- 
rispondente al lato opposto alla direzione nella qua- 
le si intende dirigere il robot. In altre parole, per fare 
ruotare il robot a destra, è sufficiente azionare il mo- 
tore di sinistra mantenendo il destro fermo e vice- 
versa. Il fulcro della rotazione è corrispondente al 
centro della ruota ferma, se potessimo fare ruotare i 
due motori in direzione opposta, sarebbe possibile 
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ottenere un movimento di rotazione del robot esat- 
tamente sulla posizione posta a metà strada tra i due 
pneumatici. A questo punto sarei tentato di inserire 
in queste pagine, una sfilza di integrali e di comples- 
si calcoli matriciali corrispondenti allo sviluppo dei 
problemi di cinematica diretta ed inversa del moto 
di questo robot! Daremo invece alcuni concetti car- 
dine di cinematica dei robot mobili, rimandando il 
lettore interessato ad eventuali approfondimenti 
alla lettura dei testi citati in bibliografia. Volendo 
modellizzare il comportamento cinematico di un 
robot mobile, possiamo dire innanzi tutto che la sua 
posizione istantanea può essere definita semplice- 
mente per mezzo di tre variabili: ci troviamo di fron- 
te quindi ad un sistema dotato di tre gradi di libertà. 
Lo stato della macchina può essere individuato dalla 
sua posizione rispetto ad un ipotetico sistema di ri- 
ferimento, ad esempio cartesiano, e dal proprio 
orientamento. Supponiamo di desiderare che la 
macchina si muova da un punto di partenza 'A' e che 
per mezzo di opportuni comandi raggiunga un 
punto di arrivo 'D', variando proprio orientamento 
secondo il percorso descritto nella figura preceden- 
te: desideriamo conoscere le coordinate cartesiane e 
l'orientamento finale del robot. Il processo descritto 
fino a questo punto riguarda un problema di cine- 
matica diretta, risolvibile integrando le formule 
riportate in Fig. 4. Nel caso in cui desiderassimo in- 
vece raggiungere la posizione e l'orientamento cor- 
rispondenti alla posizione 'D', partendo dal punto A', 
ci troveremo di fronte ad un problema di cinematica 
inversa, nel quale occorre definire una strategia di 
ricerca del percorso che il robot deve mettere in atto 
fino al raggiungimento del 'goal' desiderato. In que- 
sta sede faremo soltanto un esempio di risoluzione 
del problema rappresentato in figura, poiché un al- 
goritmo di ricerca generale dei percorsi risulta abba- 
stanza complesso da sviluppare, rinviandone la trat- 
tazione ad un eventuale appuntamento futuro. 
L'ambiente esterno, dotato di ostacoli e vincoli (og- 
getti fisici, dislivelli che impediscono il movimento 
della macchina od altri mezzi in movimento), spes- 
so complica o rende talvolta impossibile la defini- 
zione del percorso da intraprendere per il raggiungi- 




mento della posizione desiderata. La risoluzione di 
un problema di cinematica inversa, giacché presup- 
pone l'interazione del robot, dotato di limitazioni di 
movimento, con il mondo esterno, presuppongono 
la presenza di sensori esterni che consentano di rile- 
vare la presenza degli ostacoli al movimento del 
robot. Ritornando al nostro esempio, possiamo defi- 
nire l'algoritmo di risoluzione del problema in que- 
stione calcolando innanzitutto le circonferenze rela- 
tive alla rotazione del robot in prossimità del punto 
di partenza A e di quello di destinazione 'D'. Il cal- 
colo della tangente alle due circonferenze fornisce la 
componente rettilinea del percorso da intraprende- 
re. In altre parole è sufficiente far ruotare il robot, 
verso destra di una quantità pari all'angolo sotteso 
dall'arco di circonferenza A-B, procedere all'avanza- 
mento in modo rettilineo fino al punto C, quindi fare 
ruotare nuovamente la macchina verso destra di un 
angolo sotteso dall'arco C-D fino al raggiungimento 
della posizione e dell'orientamento 
desiderato, corrispondente alla posi- 
zione di destinazione 'D'. La naviga- 
zione di precisione di una macchina 
industriale necessita tuttavia di una 
serie di sensori che rilevino in modo 
adeguato l'effettivo spazio percorso: 
nel nostro caso, provvederemo ad una 
taratura iniziale di alcune costanti 
caratteristiche del nostro sistema, che 
ci consentiranno di operare una 'pre- 
visione' della traiettoria percorsa dal 
robot con una ragionevole precisione. 




x<iHi/i)Jrv>(t) +vd(t)]w.aW* 




Fig. 4: La figura mostra le relazioni matem- 
atiche che legano la posizione del Robot 
alle velocità di rotazione dei pneumatici. 



Fig. 3: 1 Robot mobili ad azionamento differenziale 
(Differential Drive), hanno il vantaggio della semplicità di 
realizzazione e controllo. 



LA REALIZZAZIONE 
MECCANICA 

L'obiettivo principale della realizzazione meccanica 
è ovviamente quello di garantire una buona capacità 
motoria del nostro robot. Per mantenere la promes- 
sa fatta a molti lettori si è voluto garantire la massi- 
ma reperibilità dei materiali ed un costo complessi- 
vo molto contenuto: tutto il materiale citato in que- 
sto paragrafo è reperibile presso il sito www.opitec.it. 
La base del robot è stata realizzata con un quadrato 
di lamiera di alluminio di 20x20 cm, dotato di uno 
spessore di 1 mm (Codice Opitec 806.530), ma qua- 
lunque supporto di di- 
mensioni analoghe, an- 
che in materiale plastico 
può andare bene lo stes- 
so. I motori che garan- 
tiscono il movimento alla 
macchina sono in cor- 
rente continua, a bassa 
tensione (1,5-4,5V) e so- 
no dotati di riduttore di 
giri per aumentarne la 




Fig. 5: 1 motori utilizzati sono in corrente continua a 
basso voltaggio e dotati di ingranaggi riduttori di velocità. 
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L'apparecchiatura PC 
Explorer light è prodot- 
ta e commercializzata 
dalla Elisys s.r.l. e può 
essere acquistata al 
prezzo di € 213,60 nella 
versione light, € 99 nel- 
la versione basic e € 69 
in kit (IVA inclusa) sul 
web all'indirizzo 
www.pcexplorer.it oppure 
inviando una e-mail 
all'indirizzo 
pcexplorer@elisvs.it o 
anche telefonicamente 
al numero 0823/468565 o 
via Fax al: 0823/495483 



Fig. 6: II progetto meccanico del Robot è incluso nel file 

Base_Robot.zip '. 

coppia disponibile e diminuirne la velocità di rota- 
zione. Il rapporto di riduzione dei motori può essere 
variato semplicemente sostituendo opportunamen- 
te i vari ingranaggi del riduttore per ottenere rappor- 
ti di riduzione compresi tra 5:1 e 3125:1, che assicu- 
rano una velocità di rotazione dell'asse del motore 
compresa tra circa 6 e 4000 giri al minuto. La trazio- 
ne è assicurata da due pneumatici in gomma del 
diametro di 79mm, mentre un doppio ruotino ha lo 
scopo di garantire terzo punto di appoggio del 
piano del robot. Il progetto meccanico è incluso nel 
file allegato (Base_Robot.zip) con il nome 'Progetto_ 
Meccanico.JPG. 



Quantità 


Componente (www.opitec.it) 


Codice Opitec 


1 


Lamiera 200x200 


806.530 


2 


Motorino con ingranaggi e riduzione 3125:1 


244.105 


2 


Pneumatico 79 mm 


844.158 


1 


Ruotino posteriore 


108.272 


2 


Profilati Alluminio 200 x 20 x 10 mm 




4 


Fermacavo per biciclette 




8 


Viti Diametro 3mm x 10 con dado 




8 


Viti Diametro 4mm x 16 con dado 




TABELLA 1: Elenco dei componenti meccanici necessari alla realizzazione della base del robot. 



ANALISI DELLO 
SCHEMA ELETTRICO 

Il circuito elettronico che andiamo ad analizzare ha 
lo scopo di garantire il controllo dei due motori a cor- 
rente continua che azionano la base robotizzata. 
Per rispondere alla legittima preoccupazione di 
molti lettori, in merito alla protezione elettrica del 
proprio PC, si è ritenuto opportuno utilizzare due 
accoppiatori ottici che assicurano una protezione ed 
un disaccoppiamento ottico tra il computer di con- 



trollo e la alimentazione elettrica dei motori. Per ga- 
rantire la massima sicurezza della realizzazione si è 
provveduto a separare anche le masse elettriche del- 
le due sezioni del circuito elettronico. Il controllo av- 
viene per mezzo della porta seriale, della quale si 
sfruttano le due linee di controllo DTR e RTS. Dal 
punto di vista concettuale il circuito è molto sempli- 
ce: quando le due linee di controllo si trovano a livel- 
lo logico High, corrispondente ad una tensione com- 
presa tra 3,5 e 25V a seconda del tipo di porta seriale, 
provvedono a fare illuminare il corrispondente diodo 
LED posto all'interno del relativo fotoaccoppiatore 
attraverso una resistenza di carico da 1 KOhm. Il 
fototransistor incapsulato nell'accoppiatore ottico 
4N25, illuminato dalla luce proveniente dal LED, si 
porta in uno stato di conduzione, permettendo il 
flusso di corrente elettrica verso la base del transistor 
di potenza TIP112 che a sua volta permette l'alimen- 
tazione del motore elettrico. Il motore inizia così ad 
azionarsi, permettendo il movimento della base del 
robot. Le due linee DTR e RTS vengono collegate a 
due diodi LED della apparecchiatura PCExplorer li- 
ght, che permettono la visualizzazione del relativo 
stato logico. Sul lato destro dello schema si possono 
notare le connessioni alle linee relative alla porta se- 
riale e di alimentazione dell'apparecchiatura PC Ex- 
plorer light. È opportuno notare che in questa confi- 
gurazione elettrica, la componente logica, (collegata 
al PC) e la parte di potenza (connessa ai motori del 
robot), sono isolate elettricamente tra di loro, garan- 
tendo la massima sicurezza del nostro Personal 
Computer. Nel caso dell'accoppiatore ottico 4N25, la 
protezione elettrica può raggiungere una differenza 
di potenziale di migliaia di volts. 



Controllore per base mobile Robot, a due motori 





(e) Luca Spunto] 



Fig. 7: In figura viene riportato lo schema elettrico del 
circuito di controllo, che per comodità e su richiesta dei 
lettori è stato inserito all'interno del file: 

Base_Robot.zip '. 



Quantità 


Componente (www.rs-components.it) 


Codice RS 


2 


Optoisolatore 4N25 


597-289 


2 


Transistor TIP 112 


436-9779 


2 


Resistenza 1000 Ohm ? W 


135-847 


2 


Resistenza 470 Ohm ? W 


132-416 


2 


Cavi 2 poli + calza 




^TABELLA 2: Elenco dei componenti elettronici necessari alla realizzazione del circuito di controllo. 



REALIZZAZIONE 
DEL CIRCUITO 
ELETTRONICO 

Il circuito elettronico per l'azionamento della base 
robotizzata può essere realizzato senza saldature 
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per mezzo della apparecchiatura PC Explorer light, 
ma anche con i soli componenti elettronici elencati 
a lato di queste pagine, per mezzo del loro montag- 
gio su una comune basetta millefori, utilizzando un 
comune saldatore a stagno. Il lettore potrà reperire i 
pochi componenti elettronici che utilizzeremo per 
la costruzione della apparecchiatura, in qualunque 
negozio di componenti elettronici, oppure per corri- 
spondenza presso la RS Components www.rs-com- 
ponents.it, l'assemblaggio del circuito può essere 
effettuato senza saldature per mezzo dell'apparec- 
chiatura PCExplorer light. 



IL SOFTWARE C++ 

Il software di controllo della nostra applicazione 
permette di risolvere problema della determina- 
zione della posizione e dell'orientamento della no- 
stra base robotizzata che, come abbiamo detto in 
precedenza, riguarda una applicazione di cinemati- 
ca diretta. Il codice sorgente, scritto in C++ viene 
messo a completa disposizione del lettore ed è di- 
sponibile nel CD con il nome 'Base_Robot.zip'. In 
questa sede analizziamo soltanto le parti più signifi- 
cative, rimanendo a disposizione del lettore per ogni 
chiarimento all'indirizzo: luca.spuntoni@iopro- 
grammo.it. L'intestazione del programma evidenzia 
i componenti utilizzati, nonché la dichiarazione del- 
le variabili globali riguardanti le coordinate assolute 
del Robot, espresse in millimetri dal punto di origi- 
ne sul piano di lavoro ed in gradi sessagesimali. 



#include 
#pragma 
#include 
#include 

// 

#pragma 
#pragma 
#pragma 
#pragma 
#pragma 
unsigned 

Extended 



<vcl.h> 
hdrstop 

"SpuntoBaseRobotUnit.h" 
<math.h> 



package(smart_init) 

link "SpuntoLedComponent" 

link "TSpuntoHardwarePortIO_unit" 

link "CSPIN" 

resource "*.dfm" //Communication parameters 
short datain, CombaseAddress, MCRAddress, 

LCRAddress, MSRAddress; 

XCoord, YCoord, Theta; //Robot Global 

Position (millimeters,millimeters,Degrees) 



La procedura FormCreate provvede ad impostare le 
variabili globali del programma, oltre che a predi- 
sporre alcuni componenti della Form. Notiamo in 
particolare l'azzeramento delle variabili corrispon- 
denti ai tre gradi di libertà dell'apparecchiatura 
(Xcoord, Ycoord, Tìieta), nonché l'impostazione degli 
indirizzi fisici corrispondenti alla porta di comuni- 
cazione seriale. 

void fastcall TSpuntoBaseRobotForm: :FormCreate( 



TObject *Sender) 
{ // Sets the Initial Coordinates 

XCoord =0; 

YCoord=0; 

Theta=0; 

// Sets the Power LED 

if(PowerONSpeedButton->Down) 

SpuntoPowerLed->LedOn(); 
else 

SpuntoPowerLed->LedOff(); 

// Both Motor Buttons Up 

LeftMotorFWD->Down = False; 

RightMotorFWD->Down = False; 

// Default (COMI) Port setup 

CombaseAddress=0x03f8; 

MCRAddress=CombaseAddress+4; 

LCRAddress=CombaseAddress+3; 

MSRAddress=CombaseAddress+6; } 



Il cuore del programma 
risiede nella funzione 
MainTimerTimer, chia- 
mata dal timer MainTi- 
mer una volta al secondo. 
Vengono definite innan- 
zitutto due variabili loca- 
li che hanno lo scopo di 
contenere il valore di ve- 
locità, espresso in milli- 
metri al secondo del 
pneumatico sinistro e di 
quello destro (LeftComp, 
RightComp). 





Fig. 8: L'immagine mostra un dettaglio del posizionamen- 
to dei componenti elettronici. 



void fastcall TSpuntoBaseRobotForm: :MainTimerTìmer( 

TObject *Sender) 

{ //Main Timer 

Extended LeftComp, RightComp; //Left and Right 

movement components 

Nel caso in cui il pulsante di alimentazione sia atti- 
vato, viene acceso il LED corrispondente sulla form 
e si provvede a leggere lo stato delle linee della porta 
seriale. A questo punto vengono verificate le posi- 
zioni dei pulsanti corrispondenti allo stato di marcia 
dei motori sinistro e destro ed in caso d'attivazione 
di questi componenti, si 
provvede a modificare la li- 
nea elettrica corrispondente 
a ciascun motore, in modo da 
forzarla a livello logico HIGH. 
In particolare per azionare il 
motore di sinistra, si opera 
l'OR logico tra il valore pre- 
sente sulla porta ed il valore 
esadecimale 02h (l'OR logico 
di qualsiasi valore con 
00000010 binario corrispon- 




Fig. 9: In figura è visibile un dettaglio della connes- 
sione dei cavi dei motori del robot. 
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PRECAUZIONI 

Prima di collegare il 

circuito al nostro PC 

occorre verificare la 

nostra realizzazione 

con attenzione per 

assicurarci che tutto sia 

stato collegato come 

previsto. 



de a forzare il bit ni ad ' 1 ') . Per arrestare il motore di 
sinistra si opera YAND logico del valore della porta 
con FDh, in modo da forzare il bit ni a '0'. In modo 
analogo per la gestione del motore destro viene ope- 
rato YOR logico del valore della porta con Olh per 
azionarlo e YAND con Feh per arrestarlo, operazioni 
che modificano entrambe il bit nO del registro MCR 
della porta seriale. Terminata la definizione dello 
stato logico dei primi due bit del registro MCR, si 
opera la scrittura del byte ottenuto per mezzo dell'i- 
struzione SpuntoHardwarePort->WritePort(MCRAd- 
dress, datain). 

if (PowerONSpeedButton->Down) //Power is ON 
{ SpuntoHardwarePort->LedOn(); 
datain =SpuntoHardware Po rt->ReadPort(MCRAddress); 
DelayTimer->Enabled=true; 
if (LeftMotorFWD->Down = =True) // Left Motor On 

{ datain = (datain | 0x02); } 

else // Left Motor Off 

{ datain = (datain & Oxfd); } 

if (RightMotorFWD->Down = =True) // Right Motor On 

{ datain = (datain | 0x01); } 

else // Right Motor Off 

{ datain = (datain & Oxfe); } 

SpuntoHardwarePort->WritePort(MCRAddress,datain); } 
else 
{ SpuntoHardwarePort->LedOff(); // Power is OFF 
datain =SpuntoHardware Po rt-> Read Po rt(MCRAddress); 

datain = (datain & Oxfc); //DTR and RTS '0' 

SpuntoHardwarePort->WritePort(MCRAddress,datain); 
DelayTimer->Enabled=false; 
LeftMotorFWD->Down=False; // Both Motor Buttons Up 

RightMotorFWD->Down = False; 

} 



{ LeftComp=0; // Left Motor Off } 

if (RightMotorFWD->Down==True) // Right Motor On 

{ RightComp=mypi*RightWheelDiameterSpinEdit->Value/( 

RightTimeConstantSpinEdit->Value/10);} 

else 

{ RightComp=0; // Right Motor Off} 

Il primo parametro cinematico ad essere calcolato è 
l'angolo Tìieta, che definisce l'orientamento della 
base robotizzata rispetto alla direzione di partenza, 
calcolato in gradi sessagesimali e positivo quando 
la rotazione è antioraria. È possibile riconoscere la 
formula descritta in precedenza, per la risoluzione 
della quale è operata un'integrazione ad intervalli 
prefissati per default di un secondo. In modo analo- 
go vengono calcolate le coordinate assolute del 
Robot: è degna di nota la conversione da gradi ses- 
sagesimali a radianti (1 Radiante^ 180/K Gradi} che 
viene operata all'interno delle funzioni relative al 
calcolo delle coordinate X e Y. 

Il Theta Calculation 
Theta= Theta+(0.5*(RightComp-LeftComp)*( 

MainTimer->Interval/1000)); 

// X Coordinate calculation 
XCoord=XCoord+(0.5*(LeftComp+RightComp)*(cos( 
Theta*(mypi/180)))*(MainTimer->Interval/1000)); 
// Y Coordinate calculation 

YCoord=YCoord+(0.5*(LeftComp+RightComp) *(sin( 
Theta*(mypi/180)))*(MainTimer->Interval/1000)); 

Qualora l'orientamento della apparecchiatura ecce- 
da dai limiti 0-360°, si provvede a riportare il valore 
dell'angolo entro questi valori. 




Fig. 10: La precisione direzionale del robot è favorita 
dalla notevole distanza presente tra i due pneumatici 
dotati di trazione. 



La risoluzione del proble- 
ma cinematico diretto di 
calcolo delle coordinate e 
dell'orientamento del Ro- 
bot avviene calcolando le 
velocità di avanzamento di 
ciascun pneumatico, 
acquisendo direttamente i 
parametri fisici del diame- 
tro dei pneumatici e di 
velocità di rotazione dai 
componenti LeftWheel- 
DiameterSpinEdit e LeftTi- 
meConstantSpinEdit: que- 
st'ultimo parametro in 
particolare viene ricavato misurando il tempo im- 
piegato da ciascuna ruota per compiere dieci giri 
completi. 

if (LeftMotorFWD->Down = =True) // Left Motor On 
{ LeftComp=mypi*LeftWheelDiameterSpinEdit->Value/( 
LeftTimeConstantSpinEdit->Value/10); } 



//Theta angle correction 

if (Theta>360) Theta = (Theta-360); 

if (Theta<0) Theta = (Theta+360); 

Al termine della fase di calcolo vengono impostate le 
etichette della form che provvedono a visualizzare i 
dati cinematici della nostra base robotizzata. 

//Sets the labels 

ThetaStaticText->Caption = FloatToStr(Theta); 
XcoordStaticText->Caption = FloatToStr(XCoord); 
YcoordStaticText->Captìon = FloatToStr(YCoord); 
Leftwheelspeed->Caption = FloatToStr(LeftComp); 
Rightwheelspeed->Caption = FloatToStr(RightComp); } 



ESECUZIONE 

ED INSTALLAZIONE 

DEL PROGRAMMA 

L'installazione e l'esecuzione del programma non 
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crea difficoltà, il software viene fornito anche nella 
versione completamente compilata e collaudata. 
Per garantire una miglior portabilità con le versio- 
ni successive il programma è stato sviluppato con 
Borland C++ Builder 4. 1 programmatori che utiliz- 
zano VC++ non dovrebbero comunque riscontrare 
problemi nel caso di utilizzo dei codici sorgenti in 
questo tipo di ambiente. Tutti i file necessari 
all'utilizzo del programma sono presenti in forma 
compilata e dotati di codice sorgente all'interno 
del file: Base_Robot.zip. Sono stati utilizzati due 
componenti sviluppati con Delphi (TspuntoHard- 
warePortlO e SpuntoLedComponent) che vengono 
distribuiti nel file allegato al CD della rivista in 
forma compilata e dotati dei relativi files '.hpp': 
chiunque desideri ricevere il codice sorgente di 
questi componenti può richiederli all'indirizzo 
spuntosoft@tiscali.it. L'utilizzo del programma su 
sistemi dotati di Win 2000, XP oppure NT, è possi- 
bile seguendo le istruzioni riportate di seguito. Al 
fine di consentire l'esecuzione del software, poi- 
ché questo accede direttamente all'hardware della 
macchina, è necessario installare il driver: 'Port- 
Talk - A Windows NT/ 2000/XP I/O Port Device Dri- 
ver Version 2.2' scaricabile all'indirizzo: 'http:// 
www.beyondlogic.org/porttalk/porttalk.htm'. Il file 
'Porttalk22.zip' contiene tutte le istruzioni neces- 
sarie all'utilizzo corretto del driver, nonché una 
notevole mole di informazioni relative all'accesso 
delle porte hardware del PC: viene fornito inoltre il 
codice sorgente completo delle applicazioni. Per 
quanto riguarda l'utilizzo del programma propo- 
sto in questa sede sotto Win 2000/NT/XP è suffi- 
ciente estrarre i file contenenti il driver 'Porttalk' 
nella directory del programma da utilizzare e 
'chiamare' l'applicazione 'SpuntoBaseRobot.exe' 
per mezzo del comando: 'C:\> Allowio Spun- 
toBaseRobot.exe/ a' che consente l'accesso da parte 
dell'eseguibile 'SpuntoBaseRobot.exe' a tutte le 
porte del PC. Lanciando il programma si ottiene 
una unica finestra contenente pochi comandi dal- 
l'utilizzo abbastanza intuitivo. La prima operazio- 
ne da compiere riguarda l'impostazione delle co- 
stanti di tempo di ogni motore, ricavata semplice- 
mente misurando il tempo impiegato da ciascun 
pneumatico a compiere dieci rotazioni complete: 
nel nostro caso abbiamo inserito 125 secondi per 
ciascun asse. Occorre impostare successivamente 
il diametro di ciascun pneumatico: questa appli- 
cazione può infatti gestire anche robot asimmetri- 
ci, ad esempio perché dotati di ruote di differenti 
dimensioni in caso di applicazioni speciali. Sele- 
zioniamo, a questo punto, la porta seriale sulla 
quale è collegata l'applicazione e premiamo il pul- 
sante 'ON I OFF'. Premendo i pulsanti di attivazio- 
ne dei motori (Left Motor e Right Motor), possiamo 
alimentare i rispettivi azionatori, notando che il 
programma inizia a calcolare le coordinate relative 



alla posizione del robot, misurate dal punto di 
partenza ed espresse in millimetri e gradi sessan- 
gesimali. È possibile azzerare le coordinate del ro- 
bot premendo il pulsante 'Reset Robot Coordi- 
natesi A questo punto la applicazione è completa 
ed è possibile verificare il funzionamento della no- 
stra base robotizzata: personalmente ho verificato 
che la precisione nei calcoli della posizione e del- 
l'orientamento del sistema è contenuto entro i li- 
miti prefissati dell' 1% di errore, trasportando un 
carico utile di circa tre kilogrammi, più che suffi- 
ciente per trasportare la colazione dalla cucina alla 
camera da letto! 
ir — hmibii.1 
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CODICE 
ALLEGATO 
ALLA RIVISTA 

Il codice sorgente della 
applicazione e tutti i 
componenti necessari 
sono reperibili sul CD 
allegato alla rivista 
all'interno del file: 
'Base Robot.zip'. 




Fig. 11: II software descritto in queste pagine è presente 
nel CD allegato alla rivista e sul sito web www.ioprogram- 
mo.it completo di codice sorgente (Base_Robot.zip). 



CONCLUSIONI 

Nonostante il limitato 
spazio a disposizione, 
abbiamo visto come 
realizzare una base ro- 
botizzata completa: il 
progetto dello schema 
elettrico e meccanico, 
tutti i collegamenti ne- 
cessari, il software com- 
pilato ed i relativi codici 
sorgenti sono stati mes- 



L'autore è lieto di 
rispondere ai quesiti 
dei lettori 

sull'interfacciamento 
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Fig. 12: Il programma è in grado di calcolare con preci- 
sione la posizione del Robot. 



si a completa disposi- 
zione del lettore. Il letto- 
re vorrà comprendere 
che, nonostante quanto 
esposto in queste pagi- 
ne sia stato debitamente 

verificato e collaudato, tuttavia viene riportato a 
scopo illustrativo e di studio, pertanto l'editore e 
l'autore non sono da considerare responsabili per 
eventuali conseguenze derivanti dell'utilizzo di 
quanto esposto in questa sede, soprattutto per la 

tipologia e la complessità dell'argomento. 

Luca Spuntoni 



Theta: 29,0855738218755 
X: -724,77989275036 

Y: 159.357591153009 
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Sfruttare le funzioni XML avanzate di Office 2003 

Fattura automatiche 
con Smart Document 

Analisi su come implementare uno Smart Document utile 

per la gestione dei dati di un documento contabile. 

In modo semplice la problematica XML su Office sarà risolta. 



Gli Smart Document costituiscono l'innova- 
zione più importante introdotta in Office 
2003 Professional. Sono strumenti che uni- 
scono i vantaggi delle applicazioni desktop con 
quelli della tecnologia XML. Gli Smart Document, 
per quanto riguarda l'intelligenza "contestuale", 
sono l'evoluzione degli Smart Tag e, come vedremo, 
non forniscono soltanto suggerimenti! Gli Smart 
Document sono creati con lo Smart Document Soft- 
ware Development Kit che può essere scaricato dal 
sito della Microsoft. In questo e nel successivo ap- 
puntamento descriveremo come sviluppare uno 
Smart Document e, come esempio, presenteremo 
una "fattura intelligente" che, durante la compila- 
zione, in base alle scelte dell'utilizzatore, può gestire 
diversi scenari operativi. Prima di addentrarci nello 
sviluppo, parleremo delle parti principali dello 
Smart Document Software Development Kit. Gli 
esempi che presenteremo sono stati sviluppati e 
testati sulla piattaforma Office 2003 Professional - 
Windows XP Per affrontare lo studio degli Smart 
Document bisogna avere delle conoscenze sull'XML 
e sugli Smart Tag per questo vi consigliamo di con- 
sultare i nostri precedenti artìcoli. 



SMART DOCUMENT 

Utilizzabili con Word 2003 ed Excel 2003, gli Smart 
Document sono strumenti, particolarmente utili per 
la creazione di soluzioni che si sviluppano secondo 
un determinato processo. Gli Smart Document, per 
esempio, sono utilizzabili per la creazione di docu- 
menti contabili, report speciali, documenti legali, 
contratti, articoli per giornali ecc; in buona sostanza, 
per tutti quei documenti che devono essere modifi- 
cati, approvati, compilati seguendo un particolare 
percorso e soltanto da persone autorizzate. Per 
capirci, prendiamo in considerazione il caso della 
compilazione di un ordine di vendita: il venditore 
crea un ordine e lo passa al suo responsabile per 



l'approvazione. Quest'ultimo, dopo l'approvazione, 
lo passa al responsabile del magazzino per la verifi- 
ca e la consegna della merce. In questo caso, se 
gestissimo il tutto con uno Smart Document, i vari 
passaggi del documento potrebbero essere attivati 
attraverso dei pulsanti, il riconoscimento degli uten- 
ti potrebbe avvenire automaticamente ed i dati dei 
clienti, degli articoli ecc. potrebbero essere recupe- 
rati da un database. Gli Smart Document possono 
essere implementati con vari linguaggi (Visual Basic 
6, C#, C++ eVB Net), sia in tecnologia COM che .NET, 
e possono interagire con database Access e Sql- 
Server. È anche possibile inviare email attraverso 
Outlook o creare presentazioni in PowerPoint. Gli 
Smart Document possono essere sviluppati per una 
rete locale o geografica e quindi usare Web Service e 
Siti Web basati su SharePoint Portai Server 2003. Uno 
Smart Document completo, in generale, può com- 
prendere differenti tipi di file, alcuni fondanti ed altri 
dipendenti dalle funzionalità implementate e da 
come sarà distribuito. 



SMART 
DOCUMENT SDK 

Lo Smart Document SDK è lo strumento da utilizza- 
re per implementare uno Smart Document. Esso è 
un ottimo supporto per lo sviluppo di Smart 
Document con le tecnologie COM e .NET La guida 
dell'SDK è divisa in diverse sezioni che forniscono 
informazioni sulla pianificazione, sullo sviluppo, 
sulla distribuzione e sulla sicurezza degli Smart 
Document. Con l'SDK, inoltre, è fornito il tool 
XMLSign, per la certificazione degli XML Espansion 
Pack, e il file "Disable XML Expansion PackManifest 
Security" per la disattivazione del processo di verifi- 
ca della certificazione dello Smart Document. Que- 
sto file è un file del registro di sistema, di una sola 
riga, che serve per cambiare il valore della DWord 
"DisableManifestSecurityCheck". 




n 




REQUISITI 



■w.i.i.wmi; 



— Conoscenze base 

LJ di XML 



Office 2003 
Professional, Smart 
Document Software 
Development Kit 
Sdocsdk.msi su 
www.microsoft.com/ 
downloads 






Tempo di realizzazione 
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INTERFACCIA 
E IMPLEMENTS 

Per implementare 

un'interfaccia, in un 

modulo di classe, 

bisogna anteporre, al 

nome dell'interfaccia, 

la parola chiave 

Implements. Questo 

comporta la creazione 

di tutti gli attributi e 

metodi pubblici 

dell'interfaccia nel 

modulo di classe. 

Ricordiamo che per 

"contratto" il modulo 

di classe dovrà 

implementare tutti gli 

elementi 

nell'interfaccia. 



IL PRIMO 

SMART DOCUMENT 

Innanzitutto precisiamo che gli Smart Document 
forniscono suggerimenti, attraverso la scheda Azio- 
ni Documenti, sul Riquadro Attività. Quando si apre 
un documento, che ha associato un pacchetto di 
espansione XML, viene aperto automaticamente il 
riquadro Azioni Documenti con delle informazioni 
e gli strumenti per compiere delle azioni; le altre 
informazioni e gli altri strumenti, programmati 
nello Smart Document, verranno mostrate man 
mano che si selezioneranno gli elementi XML pre- 
senti sul documento. L'esempio che illustreremo in 
questo e nel successivo appuntamento è una Smart 
Fattura che si auto -struttura in base alle scelte fatte 
dall'utilizzatore. Quest'ultimo può scegliere i dati 
identificativi ed il logo dell'azienda, i dati del desti- 
natario (il cliente), il tipo di pagamento, dei fram- 
menti di testo (con i quali l'azienda fornisce delle 
informazioni)... ed altre cose che vedremo nel suc- 
cessivo appuntamento. Per illustrare la tecnologia 
alla base degli Smart Document, presenteremo, sol- 
tanto, come gestire i dati dei Clienti ed il logo azien- 
dale. Questo ci permetterà di capire come ammini- 
stare il pannello Azioni Documenti (e di utilizzare 
uno schema XSD simile a Persona.xsd illustrato nei 
precedenti articoli). 

Prima d'introdurre l'esempio presentiamo la 
ISmartDocument. 
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Microsoft Smart Tags 1 .0 Type Library 

Location: C:\Prograrn Files\Cornmon Files\Microsoft 5hared\5nwt Tag\M 
Language: 5tandard 



Fig. 1: L 'errore nel riferimento alla librerìa degli 
Smart Document. 



^Metodo 


Breve descrizione 


Populei teCh eckbox 


Specifica il valore iniziale di un check box 


PopulateDocumentFragment 


Utilizzato per specificare un frammento di 
testo da inserire nel riquadro azioni 


PopulateHelpContent 


Utilizzato per specificare un file di Help 


Populatelmage 


Specifica un'immagine da caricare 


PopulateListOrComboContent 


Utilizzato per specificare il contenuto di una 
listbox o di un combobox 


PopulateTextboxContent 


Specifica il contenuto di un textbox 


SmartDocInitìalìze 


Specifica l'azione da fare quando si inizializza 
lo smart document 


, TABELLA 1: Alcuni metodi della ISmartDocument. 



ISmartDocument 

L'interfaccia ISmartDocument fornisce l'accesso alla 
Smart Document API. L'interfaccia ha diverse pro- 
prietà e diversi metodi per amministrare i controlli 
(dello Smart Document) da mostrare sul riquadro 
Azioni Documenti. 

Nelle Tabelle 1 e 2 abbiamo riportato alcuni degli 
elementi della ISmartDocument. La Tabella 3, inve- 
ce, contiene alcuni degli oggetti che possono essere 
gestiti sul riquadro Azioni Documenti (valori della 
proprietà ControlTypeFromID). 



SMART CLIENTI 

Per implementare, in Visual Basic 6, uno Smart Do- 
cument che permette di gestire i dati dei clienti ed 
logo aziendale, di un documento contabile, abbia- 
mo bisogno, almeno, dei seguenti elementi. 

1 . Uno schema XML che definisce gli elementi sen- 
sibili al "contesto". Nel nostro caso gestiamo i se- 
guenti elementi: ragionesociale, indirizzo, città, 
tipo cliente e logo aziendale. 

2. Un progetto DLL Activex, che attraverso l'inter- 
faccia ISmartDocument, permette di gestire gli 
oggetti associati agli elementi XML. Nel nostro 
caso dei textbox (per ragionesociale ed indiriz- 
zo), un ComboBox (per le città), una listbox (per 
tipo cliente) ed un controllo immagine (per 
logo). 

3. Un file Manifestami (ed altri elementi) per di- 
stribuire lo Smart Document, questo lo vedremo 
nel prossimo articolo. 



LO SCHEMA 

Ricordiamo che lo schema XSD serve per definire la 
struttura dei documenti XML. Nel nostro caso lo 
schema lo nominiamo "clienteelogo.xsd". Di seguito 
riportiamo il codice dello schema. 

<xsd:schema xmlns:xsd = 

"http://www.w3.org/2001/XMLScherna" 

xmlns="clienteelogo" 
targetNamespace="clienteelogo" 
elementFormDefault="qualified"> 
<xsd:complexType name="clienteelogo"> 
<xsd:all> 

<xsd:element name="ragionesociale" type="xsd:string" /> 
<xsd:element name="indirizzo" type="xsd:string" /> 
<xsd:element name = "citta" type="xsd:string" /> 
<xsd:element name="tipo" type="xsd:string" /> 
<xsd:element name="logo" type="xsd:string" /> 
</xsd:all> 
</xsd:complexType> 
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<xsd:element name="clienteelogo" type="clienteelogo"/> 
</xsd: schema > 

Nello schema abbiamo previsto un ComplexType 
con l'elemento "ali" (così nei file XML gli elementi 
non devono essere posti nell'ordine definito nello 
schema). Ricordiamo che lo schema ai documenti 
Word (Excel), può essere associato con la maschera 
"Modelli e Aggiunte". Dopo aver associato lo schema 
dovete creare un documento XML (Fig. 2). Ora de- 
scriviamo come implementare la DLL che associa 
degli oggetti (e delle azioni) agli elementi XML che 
avranno intelligenza "contestuale". 
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Fig. 2: La struttura XML dell'esempio. 



rappresenta il numero di elementi che hanno asso- 
ciato un controllo, nel nostro caso 5 dato che preve- 
diamo: due textbox, un combobox, una listbox e un 
controllo immagine. La variabile strPath conterrà il 
path del documento (o cartella Excel) come vedre- 
mo tra poco. Il primo metodo che consideriamo è 
SmartDocInitialize. 

Private Sub ISmartDocument_SmartDocInitialize(..., _ 
ByVal Document As Object,... ,...) 

strPath = Document. Patri & "\" 

End Sub 




Proprietà 


Breve descrizione 


ControlCaptionFromID 


Specifica la caption del controllo 


ControlCount 


Specifica il numero di controlli associati ad un 
elemento XML 


ControlID 


Specifica l'ID di un controllo. 


ControlNameFromID 


Specifica una stringa che può essere usata per 
l'accesso ai controlli conVBA. 


ControlTypeFromID 


Specifica il tipo di controllo 


SmartDocXmlTypeCaption 


Specifica la caption per un gruppo di controlli 


SmartDocXmlTypeCount 


Specifica il numero di elementi che hanno associato 
azioni nello Smart Document 


SmartDocXmlTypeName 


Specifica il nome dell'elemento con associate 
un'azione 


TABELLA 2: Le proprietà della ISmartOocument. 



IL PROGETTO 

Create un progetto DLL Activex con un riferimento 
alla seguente libreria: "Microsoft Smart Tag2.0 Type 
Library". Attenzione! In alcuni casi, nella finestra dei 
riferimenti, è mostrato un riferimento alla prima 
versione della libreria cioè "Microsoft Smart Tag 1.0 
Type Library" (Fig. 1 ) , p er risolvere il problema (dopo 
l'associazione) basta chiudere e riaprire il progetto. 
Vediamo le dichiarazioni da inserire nella classe del 
progetto. 

Implements ISmartDocument 

Const cNAMESPACE As String = "clienteelogo" 

Const cRSOCIALE As String = cNAMESPACE & 

"#ragionesociale" 
Const cINDIRIZZO As String = cNAMESPACE & "indirizzo" 
Const cCITTA As String = cNAMESPACE & "#citta" 

Const cTIPO As String = cNAMESPACE & "#tipo" 

Const cLOGO As String = cNAMESPACE & "#logo" 

Const cTYPES As Integer = 5 

Private strPath As String 



Valore ControlTypeFromID 


Elemento specificato 


C TYPE ACTIVEX 


ActiveX control 


C_TYPE_BUTTON 


Command button. 


C_TYPE_COMBO 


Comho box 


CJYPEJXXVMENTFRAGMENT 


Frammento di documento 


CJYPEJÌELP 


Help 


CTYPEJMAGE 


Immagine 


CTYPELABEL 


Label 


C_TYPE_UNK 


Link 


C_TYPE_LISTBOX 


List box 


^JYPEJEXTBOX 


TextBox 


^TABELLA 3: Alcuni controlli gestiti dagli Smart Document. 



Nella procedura precedente impostiamo il valore 
della strPath sul path del documento che si sta cre- 
ando. La strPath sarà considerata quando carichere- 
mo le immagini per il logo. Notate che della pro- 
cedura abbiamo riportato soltanto l'argomento uti- 
lizzato. Procediamo impostando il codice per i vari 
elementi XML associati ai controlli mostrati sul 
riquadro Azioni Documenti. 



Con la prima istruzione si dichiara che nel modulo 
di classe verrà implementata l'interfaccia ISmartDo- 
cument. Le dichiarazioni delle costanti, invece, ri- 
guardano gli elementi dichiarati nel file clienteelogo. 
In particolare, dichiariamo una costante (nel forma- 
to namespace#nomeelementó) per ogni elemento 
definito nello schema (attenzione ai nomi, poiché 
l'XML è case-sensitive). La costante cTYPES, invece, 



DAGLI ELEMENTI 
XML Al CONTROLLI 

Definiamo numero di elementi XML che hanno 
associato un controllo per far ciò usiamo la seguente. 

Private Property Get ISmartDocument_ 

SmartDocXmlTypeCountO As Long 
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ISmartDocument_SmartDocXmlTypeCount 
End Property 



cTYPES 



jt: 




GLOSSARIO 



ISmartDoc- 
Properties 

Questa interfaccia 

permette di 

amministrare le 

proprietà principali 

dello Smart Document 

quali posizione dei 

controlli nel riquadro 

azioni documenti, 

caratteristiche dei 

controlli che 

contengono del testo, 

caratteristiche dei 

controlli con più righe 

(combobox, listbox) o 

che possono contenere 

password (textbox), 

caratteristiche delle 

immagini, 

caratteristiche dei 

frammenti di 

documenti o di help e 

dei controlli Activex 

mostrati sul riquadro 

azioni documenti. 



Specifichiamo i nomi degli elementi, associati, alle 
azioni dello Smart Document, attraverso le costanti 
definite prima. 

Private Property Get ISmartDocument SmartDocXmlTypeName 

(ByVal XMLTypelD As Long) As String 

Select Case XMLTypelD 

Case 1 

ISmartDocument_SmartDocXmlTypeName = 

cRSOCIALE 

Case 2 

ISmartDocument_SmartDocXmlTypeName = 

cINDIRIZZO 

Case 3 

ISmartDocument_SmartDocXmlTypeName = cCITTA 

Case 4 

ISmartDocument_SmartDocXmlTypeName = cTIPO 
Case 5 

ISmartDocument_SmartDocXmlTypeName = cLOGO 
Case Else 
End Select 
End Property 

Specifichiamo le Caption che verranno mostrate sul 
riquadro Azioni Documenti. 

Private Property Get ISmartDocument_ 

SmartDocXmlTypeCaption( _ 

ByVal XMLTypelD As Long,) As String 

Select Case XMLTypelD 

Case 1 

ISmartDocument_SmartDocXmlTypeCaption = 
"Ragione Sociale" 
Case 2 

ISmartDocument_SmartDocXmlTypeCaption = 

"Indirizzo" 
Case 3 

ISmartDocument_SmartDocXmlTypeCaption = "Città" 

Case 4 

ISmartDocument_SmartDocXmlTypeCaption = 

"Tipo Cliente" 
Case 5 

ISmartDocument_SmartDocXmlTypeCaption = 
"Seleziona il logo" 
Case Else 
End Select 
End Property 

Ora definiamo i controlli per ogni tipo definito in 
precedenza. Per fare ciò utilizziamo i seguenti ele- 
menti: 

1. ControlCount per specificare il numero di con- 
trolli dello stesso tipo; 

2. ControlID per assegnare un identificatore nu- 
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Fig. 3: Fase di caricamento del pacchetto clienteelo- 
go Smart. 

merico, univoco, ai controlli; 

3. ControlNameFromID per specificare il nome 
che potrà essere usato conVBA; 

4. ControlCapitionFromID per specificare la cap- 
tion del controllo, mostrata nel riquadro attività; 

5. ControlTypeFromID per specificare il tipo di 
controllo. 

Private Property Get ISmartDocument_ControlCount( _ 

ByVal XMLTypeName As String) As Long 

Select Case XMLTypeName 

Case cRSOCIALE 

ISmartDocument_ControlCount = 1 

Case cINDIRIZZO 

ISmartDocument_ControlCount = 1 

Case cCITTA 

ISmartDocument_ControlCount = 1 

Case cTIPO 

ISmartDocument_ControlCount = 1 

Case cLOGO 

ISmartDocument_ControlCount = 2 
"inseriamo due immagini sulla scheda azioni 

documenti 
Case Else 
End Select 
End Property 
Private Property Get ISmartDocument_ControlID( _ 

ByVal XMLTypeName As String, _ 

ByVal Controllndex As Long) As Long 

Select Case XMLTypeName 

Case cRSOCIALE 

ISmartDocument_ControlID = Controllndex 

Case cINDIRIZZO 

ISmartDocument_ControlID = Controllndex + 100 

Case cCITTA 

ISmartDocument_ControlID = Controllndex + 200 

Case cTIPO 

ISmartDocument_ControlID = Controllndex + 300 

Case cLOGO 

ISmartDocument_ControlID = Controllndex + 400 
End Select 
End Property 
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Private Property Get ISmartDocument_ControlNameFromID 

(ByVal ControlID As Long) As String 

ISmartDocument_ControlNameFromID = 

cNAMESPACE & ControlID 

End Property 

Private Property Get ISmartDocument_ 

ControlCaptionFromID( _ 

ByVal ControlID As Long, ,,,,,) As String 

Select Case ControlID 
Case 1 

ISmartDocument_ControlCaptionFromID = _ 

"Inserire la ragione sociale ..." 

Case 101 

ISmartDocument_ControlCaptionFromID = _ 

"Inserire l'indirizzo:" 

Case 201 

ISmartDocument_ControlCaptionFromID = _ 

"Selezionare la città:" 

Case 301 

ISmartDocument_ControlCaptionFromID = _ 

"Selezionare il tipo di cliente:" 

Case 401, 402 

ISmartDocument_ControlCaptionFromID = _ 

"Selezionare il logo:" 
Case Else 
End Select 
End Property 

Private Property Get ISmartDocument ControlTypeFromID 
(ByVal ControlID As Long, , ) As SmartTagLib.C_TYPE 
Select Case ControlID 
Case 1 

ISmartDocument_ControlTypeFromID = 
C_TYPE_TEXTBOX 

Case 101 

ISmartDocument_ControlTypeFromID = 

C_TYPE_TEXTBOX 

Case 201 

ISmartDocument_ControlTypeFromID = 

C_TYPE_COMBO 

Case 301 

ISmartDocument_ControlTypeFromID = 

C_TYPE_LISTBOX 

Case 401, 402 

ISmartDocument_ControlTypeFromID = 

C_TYPE_IMAGE 

Case Else 
End Select 
End Property 

Per inserire dei valori nei controlli ListBox, Imma- 
gine e ControlBox usiamo le seguenti. 

Private Sub ISmartDocument_PopulateImage(ByVal 

ControlID As Long, ,,,,,, ImageSrc As String) 
Select Case ControlID 

Case 401 

ImageSrc = strPath & "logol.bmp" 
Case 402 



ImageSrc = strPath & "logo2.bmp" 
End Select 
End Sub 
Private Sub ISmartDocument_ 

PopulateListOrComboContent( ByVal _ 
ControlID As Long, ,,,,,, List() As String, Count As 
Long, InitialSelected As Long) 
Select Case ControlID 

Case 201 

Count = 5 

ReDim List(l To 5) As String 

List(l) = "Bari" 

List(5) = "Napoli" 

InitialSelected = -1 
Case 301 

Count = 5 
ReDim List(l To 5) As String 

List(l) = "farmacista" 

List(5) = "meteorologo" 
InitialSelected = -1 
End Select 
End Sub 

A questo punto bisogna aggiungere il codice che im- 
posta le azioni dei controlli e compilare la DLL. 




MAIMIFEST 

Per associare lo Smart 
Document alle 
applicazioni Office 
2003 possiamo 
utilizzato un XML 
Espansion Packs 
composto dai file dello 
Smart Document è 
gestito dal file 
"Manifest.xml". 
Questo però non è 
l'unico modo per 
distribuire gli Smart 
Document, come 
vedremo nel prossimo 
appuntamento. 
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Fig. 4: lì riquadro Azioni Documenti che mostra un combobox. 



CONCLUSIONI 

Nello spazio a nostra disposizione non abbiamo po- 
tuto completare l'esempio, infatti, ancora dobbiamo 
spiegare come associare delle azioni ai controlli, co- 
me implementare il file Manifest.xml e come utiliz- 
zare il file che disabilita il controllo sulla certificazio- 
ne del codice e perché è necessario. 
Nel successivo appuntamento oltre a completare gli 
esempi ci occuperemo deU'XML Expansion Packs e 
della sicurezza. 

Massimo Autiero 
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Programmiamo un agent per le nostre applicazioni 

Un assistente 
a tua immagine 

Nel numero scorso abbiamo programmato un assistente 
"prefabbricato". Oggi, ci cimenteremo nella costruzione 
e animazione di un personaggio da integrare nei nostri progetti! 




□ CD □ WEB 

Agent_2.zip 



"j' i a "• a 



n 




REQUISITI 



H.I.NWJ.HJJ. 



— Basi di Visual Basic 



Microsoft Windows 95 
o successive. Visual 
Basic 6.0 



Tempo di realizzazione 







Cominciamo col tranquillizzare chi si 
fosse perso l'appuntamento della volta 
scorsa. Per poter seguire questa punta- 
ta basterà procurarsi lo stretto necessario, 
disponibile gratuitamente all'indirizzo http:// 
www.microsoft.com/msagent/downloads/user 
.asp. Per quanto riguarda le conoscenze "ar- 
retrate", basterà fare riferimento alla guida 
dell'SDK di Agent, o a uno dei tutorial dispo- 
nibili in rete, per mettersi rapidamente al 
passo. 

Ben diverso è il caso degli argomenti che toc- 
cheremo questa volta. Se la rete è prodiga di 
materiale sulla programmazione degli agenti 
tramite controllo o scripting, è quanto meno 
avara di informazioni circa la costruzione di 
un nuovo assistente. 

La scarsa reperibilità di informazioni e tuto- 
rial può forse trovare giustificazione nella 
complessità intrinseca di un simile argomen- 
to: quando si mescolano arte, tecnica e ani- 
mazione allo stesso tempo, stabilire un iter 
unico da seguire diventa impossibile. 
Creare un personaggio può, infatti, richiedere 
numerosi e sofisticati programmi di grafica e 
animazione, oppure semplicemente buona 
volontà e Paintbrush. 

Sta all'esperienza, al talento e all'inclinazione 
individuale la scelta dello strumento più op- 
portuno. 

Quest'articolo tratterà le fasi principali della 
realizzazione di un personaggio senza forzare 
l'uso di alcun programma specifico, anche se, 
doverosamente, vengono di volta in volta cita- 
ti gli strumenti utilizzati. 
In questa maniera l'autore spera di fare cosa 
gradita sia a chi ha gli strumenti a disposizio- 
ne e vuole cimentarvisi in maniera professio- 
nale, sia a chi non sa usarli ma non vuol per- 



dersi l'opportunità di seguire, comunque, 
l'avventura che questa puntata propone. 



IL CHARACTER EDITOR 

Qualunque strumento si utilizzi, l'indispensa- 
bile fucina per forgiare il nostro assistente è 
YACE: Agent Character Editor, disponibile, an- 
ch'esso gratuitamente, all'indirizzo www.mi- 
crosoft.com/msagent/downloads/develo- 
per.asp. 

Impareremo presto l'utilizzo di questo stru- 
mento, che, a dispetto del nome, non è un 
editor in senso stretto, quanto, piuttosto, un 
compilatore. Attraverso questo programma, 
non è infatti possibile leggere le informazioni 
contenute in un file .ACS (il file compilato di 
un assistente), come quelli di Merlin o Genie. 
I file creati tramite ACE vengono salvati in for- 
mato .ACD (Agent Character Description), il 
quale, ad un analisi col blocco note, si rivela 
essere nient'altro che una serie di direttive 
circa locazioni dei file e delle animazioni ne- 
cessari alla costruzione del personaggio. È per 
mezzo di un compilatore (interno al program- 
ma) che, successivamente, la sequenza di im- 
magini e stati memorizzati in .ACD può essere 
convertita in un singolo file .ACS. 



LA FASE CREATIVA 

Siamo così arrivati alla prima fase del nostro 
progetto: l'atto creativo. Sembrerà banale, ma 
è fondamentale sapere in anticipo cosa vo- 
gliamo realizzare, e perché. 
Il personaggio che abbiamo in mente dovrà 
soddisfare alcuni requisiti fondamentali: ri- 



»> 70/ Luglio-Agosto 2004 



http://www.ioprogrammo.it 



Interfacce amichevoli ■ T SISTEMA 




Fig. 1: Alcuni bozzetti su carta dell'assistente Fili. 

sultare simpatico per l'utente, apparire forte- 
mente caratterizzato, e prestarsi ad una ven- 
tina di animazioni diverse con grande facilità. 
É necessario, per questo motivo, visualizzare 
mentalmente il nostro personaggio che entra 
in scena, si muove, parla e saluta, si confonde 
e si annoia, e così via. 

Pensando alla possibilità di interazione fra 
più personaggi, può, ad esempio, venire in 
mente una marionetta: questa dà l'opportu- 
nità, con piccole modifiche, di far nascere ve- 
locemente un piccolo teatrino di altri perso- 
naggi da 'mettere in scena'. 
Più tempo si spende nella fase creativa, più è 
assicurata la caratterizzazione del personag- 
gio: per la nostra marionetta pensiamo a 
grandi occhi espressivi (azzurri, in modo da 
risaltare meglio sul legno), un cappello verde 
(chino da un lato, in modo da non prendere 
troppo spazio), un naso appuntito e allunga- 
bile secondo la migliore tradizione 'collodia- 
na'. 

Diamogli un nome breve e significativo, ed ec- 
co nascere l'assistente "Fili". Abbiamo com- 
piuto il primo passo importante, anche se 
quest'apparizione su carta ha, per il momen- 
to, ben poco di virtuale. 



disposizione e confrontando i risultati di 
eventuali prove effettuate. 
Prendiamo l'esempio di Fili: si tratta di un 
personaggio dai lineamenti volutamente 
squadrati, dai movimenti legnosi e dalle posi- 
zioni innaturali e quasi robotiche. Tutti questi 
fattori e la difficoltà di disegnare manualmen- 
te il legno che lo riveste in maniera coerente 
per tutti i fotogrammi delle animazioni, por- 
tano alla scelta di un programma di grafica 
tridimensionale. 

Il programma scelto per Fili è 3D Max Studio: 
la realizzazione potrà così trarre vantaggio 
dalla struttura 'spezzata' degli arti del sogget- 
to in questione. Non avendo gomiti, spalle, 
polsi e ginocchia, non ci sarà bisogno di pre- 
vedere complicate deformazioni nelle giuntu- 
re, di "pesare" i vertici, di applicare un modifi- 
catere skin su una struttura di bones, o phisi- 
que sul biped di Character Studio. 
Per ottenere una cinematica adatta ai nostri 
scopi basterà, invece, realizzare una struttura 
gerarchica di unioni ben studiata, come quella 
mostrata in Fig. 2. 
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Fig. 2: La struttura gerarchica delle componenti di Fili. 



L'IMPLEMENTAZIONE 
TECNICA 

A tutta questa progettazione tipica della 
fumettistica dobbiamo anche abbinare delle 
scelte tecniche: le vie per realizzare l'assisten- 
te, come ho già accennato, sono molte e ri- 
chiedono l'uso di programmi e competenze 
differenti. É anche vero che ognuna di queste 
può adattarsi meglio a uno specifico tipo di 
personaggio, ragion per cui è bene spendere 
molto tempo nella scelta degli strumenti, 
considerando i programmi che si hanno a 



Dallo stesso diagramma è anche possibile ri- 
cavare i nomi delle parti del corpo di Fili. Dal 
punto di vista della realizzazione grafica, si 
tratta principalmente di poligoni bidimensio- 
nali estrusi. Con questa semplice tecnica è 
possibile creare ogni componente ad eccezio- 
ne degli occhi (due sfere), del naso (un cono 
"levigato"), e del cappello (ricavato da una se- 
zione di cono cavo, modificata con una map- 
pa di noise e inclinata dinamicamente trami- 
te il modificatere bend) . 
Molta attenzione va anche prestata al tipo e 
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GLOSSARIO 



OFFICE 

Gli agenti costruiti con 

ACE possono essere 

utilizzati anche per 

Microsoft Office (solo 

per la versione 2000 e 

successive). A tal fine 

occorre supportare le 

animazioni standard di 

Office (FilelNewlOffice 

Assistant), usare 

l'apposita palette 

www.microsoft.com/ 

msaqent/download/ 

assistpalet.bmp 

e immettere il file nella 

cartella 

CX..\Application 

Data\Offìce\Actors. 




Fig. 3: Il rendering 
della restpose di Fili. 



alle opzioni del rende- 
ring. Nel caso di un 
personaggio di fantasia 
(come il nostro) tende- 
re al fotorealismo è 
sconsigliabile: meglio 
optare per una ripro- 
duzione del soggetto in 
stile fumetto. 
In 3D Max Studio è di- 
sponibile, a tal propo- 
sito, il materiale ink 'n 
paint, che implementa 
una tipologia di rende- 
ring in cartoon-shading, con possibilità di 
definire il tipo di contorni (qualità e spessore 
dell'inchiostro), ed eventuali mappe di diffu- 
sione e bump. 

A questo punto si tratta di mettere a posto gli 
ultimi elementi della scena. Impostiamo un 
colore di sfondo forte e non utilizzato dalla 
palette del personaggio: un viola brillante 
(RGB 255,0,255). Questo sarà il nostro colore 
di trasparenza, e, di conseguenza, dovremo 
prevedere un accorgimento particolare nell'u- 
so dell'antialiasing, che dovrà essere applica- 
to solo all'interno dell'area di disegno (nel no- 
stro caso, l'Ink 'n paint si prende cura auto- 
maticamente di disattivare il motion blur e 
V antialiasing esterno). Se l'antialiasing venis- 
se applicato all'intera figura, infatti, l'assi- 
stente apparirebbe circondato da un fa- 
stidioso alone violaceo, effetto della contami- 
nazione fra i contorni neri e il viola di traspa- 
renza. 

Facciamo assumere a Fili una posa adeguata e 
servizievole, e procediamo col rendering: ec- 
co la restpose del nostro assistente! Potete tro- 
vare quest'immagine nel codice di esempio 



Tavolozza — Metodo di riduzione 

(* Taglio medio ottimizzato ** Colore più simile 



H Octree ottimizzata 

H Standard/sicura per il Web 



C Retinatura ordinata 
<"" Diffusione di errore 



IL 



Opzioni 

V Incrementa i colori contrassegnati di: 

(da 1 a 1 0] 
W Includi colori di Windows 
I Riduci scolorimento 



DK 



Annulla 



Fig. 4: Le opzioni di riduzione della palette in Paint Shop Pro. 



allegato al CD [file RestPose_16M.bmp]. 



L'INTEGRAZIONE 

coni ACE 

Qualunque sia la strada tecnica che abbiamo 
deciso di intraprendere, ora ci troviamo con 
un'immagine dell'assistente 'in posa' su sfon- 



do viola. Per riuscire ad integrare il nostro fra- 
ine con ACE, dobbiamo capire come questo 
'interpreta' le animazioni e cosa richiede dalle 
nostre immagini. 

Tutto il sistema degli Agent si basa sul concet- 
to di 'animazione': ognuna di queste è realiz- 
zata attraverso una serie di fotogrammi (fra- 
mes), ed è associata a uno o più stati (states). 
Degli ultimi parleremo più avanti, mentre ora 
dobbiamo spendere un po' di tempo su fra- 
mes e animazioni. 

Il problema principale di integrazione che 
questi ci pongono è che tutti i frame di tutte le 
animazioni devono condividere necessaria- 
mente la stessa palette di base: le bitmap che 
produciamo, quindi, non solo avranno la limi- 
tazione di 256 colori a disposizione, ma do- 
vranno inoltre condividere la stessa palette, 
per di più lasciando libere le prime e le ultime 
dieci posizioni ai colori standard di Windows. 
Avremo a disposizione, solo 236 colori effetti- 
vi, i quali saranno estremamente preziosi e 
dovranno essere valutati con molta cura. 
Se questo problema non appare tanto minac- 
cioso a chi si approccia 'manualmente' al di- 
segno dell'assistente (236 colori, alla fin fine, 
rappresentano una risorsa vasta quando si 
possono scegliere volta per volta), per il no- 
stro Fili è un bel grattacapo, dal momento che 
3D Max Studio è sì in grado di generare una 
palette ottimizzata a 256 colori, ma non di 
riutilizzare la stessa per ogni immagine. 
É quindi necessario fare ricorso ad un ulterio- 
re programma, che riesca a gestire il tutto. Fra 
le scelte più comuni per questo tipo di esigen- 
ze figura il Paint Shop Pro, che può vantare 
dalla sua un ottimo sistema di gestione delle 
palette (nonché una buona versione trial, per 
chi non disponesse del prodotto). 
Grazie a quest'applicazione, potremo effet- 
tuare aggiunte post-rendering quando sarà 
necessario, e gestire i frames con l'animation 
shop, ad esempio per ottimizzare al massimo 
le dimensioni dell'assistente, ritagliando op- 
portunamente l'area animata, in modo auto- 
matico. 

Per quanto riguarda la nostra restpose (otte- 
nuta in 3D Max Studio a 16 milioni di colori) 
possiamo aprirla con Paint Shop Pro e conver- 
tirla a 256 colori (Shift+Ctrl+3), scegliendo le 
opzioni indicate in Fig. 4. 
Verrà automaticamente generata la palette ot- 
timizzata, che provvederemo a salvare (menù 
Colori/Salva tavolozza) in un file .pai. Da ora 
in poi, per ogni frame generato da 3D Max 
Studio, basterà caricare quest'ultimo, per ot- 
tenere la conversione ottimizzata del disegno. 
Avremo così ciò che ci eravamo prefissi: un'u- 
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nica palette per tutti i disegni (in RestPose- 
.Bmp è presente l'immagine convertita e rita- 
gliata). 



LA PRIMA 
ANIMAZIONE 

É quindi con lo spirito sollevato, proprio di 
chi ha risolto gran parte dei suoi problemi, 
che ci accingiamo alla realizzazione della 
prima animazione del nostro assistente! 
Aprendo TACE e cliccando sul menù File/New 
/Default Character, otteniamo uno scheletro 
di tutte le animazioni e gli stati, così come 
vengono associati secondo il modo 'standard' 
utilizzato da Windows. 

La pagina iniziale, inoltre, presenta dei campi 
da compilare (nome assistente, descrizione, 
extra, etc...): questi dati sono importanti, poi- 
ché appaiono nella finestra di scelta dell'assi- 
stente, quando viene richiamato il metodo 
ShowDefaultCharacterProperties del controllo 
Agent. 

Altrettanto importante è la schermata asso- 
ciata all'elemento animation, all'interno della 
quale dobbiamo indicare il colore (viola) di 
trasparenza. 

Espandendo il ramo Animations è possibile 
rintracciare l'animazione RestPose, che con- 
tiene un unico fotogramma e viene richiama- 
ta dal server ogni volta che l'assistente è in 
posizione neutra. È a quest'animazione che 
dovremo associare il nostro disegno appena 
creato. 

Clicchiamo col tasto destro su RestPose e sce- 
gliamo 'New Frames from Images' dal menù di 
pop-up, indi apriamo il file RestPose. Bmp. 
L'immagine del nostro simpatico assistente 
apparirà sulla preview di destra, anche se 
deformata. Ciò non deve spaventare più di 
tanto: accade perché l'assistente ha dimen- 
sioni diverse da quelle standard (128x128), ma 
in fase di esecuzione l'assistente sarà propor- 
zionato normalmente (anche se apparirà più 
grande di Genie e Merlin). 
Per vedere se tutto è andato come deve, apria- 
mo il menù File/Build Character per compila- 
re l'assistente, che salveremo come Fili.acs in 
C:\Windows\ MsAgent\Chars: la cartella pre- 
definita per gli assistenti professionali! 
Per provare il nostro operato, possiamo usare 
l'Hello World costruito la volta scorsa, con l'u- 
nico cambiamento del nome dell'assistente: 
non più "Merlin. acs", ma "Fili.acs". 
Se tutto è andato come deve, apparirà la no- 
stra marionetta, esclamando "Ciao, mondo!". 
In realtà, il verbo 'esclamare' è esagerato, dal 



momento che Fili non emetterà alcun suono, 
né, tantomeno, muoverà le labbra in alcun 
modo. 



IL PARLATO 
E GLI OVERLAY 

Non è certamente colpa di Fili, se sta fermo e 
muto. Siamo noi a dovergli dare la favella, 
cliccando sull'elemento animation e quindi 
spuntando la casella "Use syntesized speechfor 
voice output". Apparirà dinamicamente la 
nuova linguetta "Voices", all'interno della qua- 
le potremo stabilire il motore da utilizzare, il 
pitch e la velocità del parlato. 
Dal momento che Fili ha le sembianze di un 
bambino, proporrei la combinazione: "Adult 
Female #1 Italian (L&H)" (scaricato nella scor- 
sa puntata), con 166 Hz e 145 WPM. 
Basta compilare l'assistente ed eseguire il pro- 
gramma di prova, per accorgersi che, Fili è 
pronto a pronunciare concretamente tutto ciò 
che dice. 

Rimane, però, il problema del lip-sync, ovvero 
della sincronizzazione delle labbra al parlato: 
questo è un elemento importante, perché ag- 
giunge molti punti alla credibilità del nostro 
assistente. 

Chiunque abbia provato a realizzare un buon 
motore di lip-sync conosce bene le problema- 
tiche che pone una sfida del genere: fortuna- 
tamente Agent ci facilita il compito, assegnan- 
do automaticamente ad ogni fonema di base 
una fra le sette posizioni disponibili per la 
bocca. 

Cliccando sul Framel di RestPose è infatti pos- 
sibile notare una nuova linguetta (Overlays), 
che all'interno contiene i sette slot per le posi- 
zioni suddette. Basta disegnare per ogni stato 
un'opportuna posizione della bocca, in accor- 
do con l'esempio mostrato dall'applicazione 
in basso a destra. Per Fili tali disegni sono 
contenuti nei file il cui nome comincia con 
"bocca". Si può notare come queste immagini 
siano solo dei piccoli rettangoli: l'idea è quel- 
la di sovrapporli al disegno di base, coprendo 
l'area della bocca. Ciò permette di risparmia- 
re molto spazio e diversi rendering; immagini 
di questo tipo prendono il nome di overlay. 
Quando si immette un overlay è necessario 
specificare anche un offset, ovvero la posizio- 
ne delle coordinate x e y dell'angolo superiore 
sinistro in cui si vuole sovrapporre il disegno: 
per gli overlay della bocca di Fili tali valori 
sono x-52 e y=55. Possiamo ora compilare 
l'assistente e goderci un parlato preciso e pro- 
fessionale! 




Ad un singolo stato 
possono essere 
assegnate quante 
animazioni si desidera. 
In un simile caso il 
server sceglierà 
automaticamente, in 
modo casuale, una 
delle animazioni 
possibili di volta in 
volta. Sfruttando 
questo principio in 
congiunzione con il 
branching è possibile 
creare assistenti dalle 
reazioni 
sorprendentemente 



MOTA 

SUL CODICE 

Quando un 
personaggio (come il 
nostro) non supporta 
ancora l'intero 
animation set, è 
un'ottima pratica 
richiamare la restpose 
prima di qualunque 
azione. Il server 
potrebbe, infatti, 
richiamare stati non 
associati ad 
animazioni, con 
conseguente 
"bloccaggio" 
dell'assistente (ad 
esempio, questi 
potrebbe parlare senza 
muovere la bocca). 
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LA CONDIZIONE 
DELL'AGEIUT 

Come promesso, eccoci a parlare degli stati: 
cosa sono? E a cosa servono? Per rispondere a 
queste e ad altre domande, occorre conoscere 
come il server di Agent fa girare le istanze de- 
gli assistenti: a seconda di quello che viene 
richiesto dal programmatore attraverso fun- 
zioni esplicite (del tipo .Show) e di ciò che 
accade implicitamente (ad esempio l'inattivi- 
tà prolungata), il server assegna agli agenti 
degli stati: i 16 elencati dal Character Editor. 




RETURN ANIMATION 

Quando un'animazione non finisce in posa neutrale è bene 
definire anche una return animation, usando l'apposito campo 
disponibile per ogni 'elemento animazione' nella lista. Questa 
viene richiamata dal server, dopo il termine della stessa, e deve 
riportare il personaggio, gradualmente, alla restpose; ciò è volto 
ad evitare un brusco e innaturale 'salto' di ritorno. 

EXIT BRANCHING 

La return animation non fornisce sufficienti garanzie di funzionamento 
quando, usando il branching, si crea un'animazione a ciclo infinito. In tal 
caso è possibile usare l'apposito Exit Branching, che prevede un'uscita 
specifica per ogni frame, consentendo transizioni più precise. Un esempio 
di tale tecnica è fornito nell'animazione searching di "Fili.acd". 



L'AGEIMTRY 

Uno dei siti di riferimento per i creatori di ACS è sicuramente 
http://aqentrv.net, che fornisce applicativi che sfruttano questa tecnologia. 



un'impressionante collezione di oltre 400 assistenti (gratis o a pagamento), 
e può diventare un'ottima vetrina per le nostre migliori creazioni. 



Ad ognuno di questi stati è possibile assegna- 
re una o più animazioni (per quest'ultime, in- 
vece, non c'è alcun limite: è possibile creare 
quante animazioni si vuole e assegnarle a tutti 
gli stati che si desiderano coprire). Quando, 
ad esempio, l'assistente non viene usato per 
lungo tempo, viene generato uno stato di Idle, 
dapprima lieve (IdlingLevell), poi più 'grave' 
(IdlingLevel2), fino alla notifica della sonno- 
lenza completa (IdlingLevel3). 
Per standard, questi stati di Idle sono coperti 
da alcune animazioni: "Blink", ad esempio, 
viene richiamata sia per lo stato di Idlel, che 
per quello di Idle2. Possiamo verificare che, 
implementando l'animazione di blink, l'assi- 
stente sbatte automaticamente gli occhi dopo 
un periodo di inattività. Per realizzare l'ani- 
mazione, basta inserire su tre frame consecu- 
tivi l'immagine di restpose. Sul secondo, piaz- 
ziamo un overlay degli occhi chiusi (File Oc- 
chi_overlay.BMP) al posto giusto, e il gioco è 




SUL FORUM 



Per qualsiasi 

suggerimento, critica, 

approfondimento, 

l'autore può essere 

contattato sul Forum 

del sito di 

ioProgrammo. 



fatto (per aggiungere un overlay al frame 
basta premere il pulsante Add Image sulla 
toolbar contenuta nel frame Images) . É anche 
consigliato aumentare il numero di centesimi 
di secondo del frame, impostando a 20 il 
campo Duration. 



IL BRANCHING 

Quando, in Windows XP, facciamo cercare un 
file a Merlin, costui tira fuori una sfera di vetro 
e inizia la sua divinazione. Questa viene por- 
tata avanti, finché il file non viene effettiva- 
mente trovato dal programma. Il diabolico 
stratagemma non ci inganna, dato che abbia- 
mo visto nella scorsa puntata che questo 
genere di trucchi può essere realizzato richia- 
mando un'animazione continua, e passando 
il metodo Stop quando necessario. Ma com'è 
possibile realizzare un'animazione continua? 
Questa domanda è non solo legittima, ma 
necessaria, dal momento che alcune anima- 
zioni (come la "searching" , per esempio) sono 
progettate per essere dichiaratamente conti- 
nue. 

Tutto questo è possibile grazie al branching: 
per ogni frame, si possono impostare fino a 
tre 'salti' ad un altro frame (purtroppo, soltan- 
to nei limiti dell'animazione corrente), a se- 
conda di una probabilità che può andare da 
0% (salto non presente) a 100% (che equivale 
a un GoTo). Per realizzare un'animazione con- 
tinua è quindi sufficiente impostare nell'ulti- 
mo frame un branching 100% che riconduca 
alla prima. In realtà il sistema fornito da Agent 
permette loop molto più raffinati, in maniera 
che la natura meccanica della ripetizione non 
risulti troppo evidente: impostando dei salti 
con probabilità intermedie, è possibile far 
prendere all'animazione strade diverse e rom- 
pere la monotonia del ciclo. Si può studiare 
un simile comportamento consultando l'ani- 
mazione "Searching" del file Fili.asd, fornito 
nel codice di esempio. 



CONCLUSIONI 

Si conclude qui il nostro viaggio nel mondo 
degli agenti, ormai non più... segreti. Tramite 
questo giro panoramico, forse qualche lettore 
potrà trovare degli spunti interessanti, magari 
condividendo le proprie esperienze sul forum 
di ioProgrammo. E quantomeno, potrà sicura- 
mente osservare con occhi più consapevoli la 
"dannata graffetta di Office!". 

Roberto Allegra 
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Impariamo a navigare lo spazio 3P con DirectX e C# 

TVasformazioni 



in .NET 



Dopo aver visto il disegno di semplici primitive su schermo attraverso 
i Vertex Buffer e gli oggetti GraphicsStream, in questo numero 
realizziamo il movimento degli oggetti nello spazio 3D. 
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opo aver inviato tutti i vertici del nostro 
| disegno a DirectX, avvengono delle elabo- 
razioni interne per trasportare le coordina- 
te spaziali da noi inserite (3D) in coordinate dello 
schermo (2D), come mostrato nel disegno in Fig. 1: 
processo, ripetiamolo, chiamato renderizzazione. 
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Fig. 1: Processo di Render. 

Quando DirectX termina i calcoli per ogni pixel, in- 
vierà questi dati dalla memoria allo schermo: que- 
sto processo è chiamato rasterizzazione. In definiti- 
va abbiamo due fasi del processo; la prima si occu- 
pa della geometria dell'oggetto che vogliamo rap- 
presentare (vertici, triangoli, ecc); la seconda del 
trasporto sulla memoria dello schermo dei singoli 
pixel che devono essere rappresentati. La prima 
parte, essendo di natura geometrica, è governata 
dal capitolo della geometria analitica che si occupa 
delle trasformazioni. Cerchiamo di capire assieme 
di cosa si tratta. 



TRASFORMAZIONI 

Una trasformazione è un formalismo che ci permet- 
te di rappresentare con operazioni matematiche il 



processo che determina la posizione di un punto. 
Questo processo può essere una rotazione, una tra- 
slazione, una proiezione, ecc; le trasformazioni fon- 
damentalmente alterano la disposizione di punti 
all'interno di uno spazio. Fra tutti i tipi di trasforma- 
zioni si distinguono: 

Le trasformazioni proiettive, le quali conservano gli 
allineamenti fra i punti e le figure. Vengono usate 
nella trasposizione in 2D dello spazio 3D attraverso 
le regole della prospettiva. 

Le trasformazioni affini, che oltre ad esser proietti- 
ve e quindi a conservare gli allineamenti, conserva- 
no anche i rapporti fra le distanze degli oggetti. 
Le trasformazioni metriche infine, oltre ad essere 
affini, conservano anche le distanze esatte fra gli 
oggetti. 

Per chiarire meglio, consideriamo il nostro triangolo 
(base di ogni rappresentazione grafica): quando ne 
facciamo una rappresentazione prospettica il nostro 
triangolo può cambiare forma ma i suoi lati saranno 
sempre dei segmenti di retta: la trasformazione è 
proiettiva. Quando ne facciamo una rappresenta- 
zione in scala non solo i lati rimangono segmenti di 
retta, ma ne conserviamo anche i rapporti tra di- 
stanze: è una trasformazione affine. Quando le fac- 
ciamo una fotocopia conserviamo anche ogni sin- 
gola misura: le lunghezze dei lati, l'area, ecc.: è una 
trasformazione metrica. Tutte queste trasformazioni 
come insegna un branca della geometria analitica, si 
possono rappresentare quali operazioni fra i vettori 
che rappresentano le coordinate dei punti e le ma- 
trici che rappresentano le caratteristiche della tra- 
sformazione. Il formalismo generale è 

P' = P*M 

Questo formalismo ancora non ci dice in che tipo di 
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spazio (2D, 3D) stiamo lavorando e quindi si perfe 
ziona nel seguente modo: 



3D:P'(1,3)-- 
2D:P'(1,2)-. 



P(1,3)*M(3,3) + T(1,3) 
P(1,2)*M(2,2) + T(1,2) 



Come si vede con le coordinate spaziali che cono- 
sciamo occorrerà applicare due operazioni mate- 
matiche: una moltiplicazione di matrici ed una 
somma di matrici. Una ottimizzazione di questo 
processo si ha con l'introduzione delle coordinate 
omogenee che ci permetteranno di ridurlo ad una 
sola operazione: 



3D:P'(1,4)- 
2D:P'(1,3)-- 



P(l,4) *M(4,4) 
P(l,3) *M(3,3) 



Scendiamo ora più nel dettaglio e cerchiamo di 
capire come lavorare con le matrici e soprattutto 
come usarle nei nostri programmi di grafica 3D. 



MATEMATICA 
MATRICI 



Una matrice può essere pensata come una scatola di 
equazioni lineari, ma per capire bene questo con- 
cetto, dobbiamo prima capire come le matrici pos- 
sono essere moltiplicate fra loro e imparare le regole 
di queste moltiplicazioni. Per farla breve, due matri- 
ci possono essere moltiplicate fra loro solo, e solo se, 
la prima ha lo stesso numero di colonne del numero 
di righe della seconda: 

A/57/3; *B[3][7],A[1][4] *B[4][4],A[3][2] *B [2] [9] 

sono tutte moltiplicazioni valide, mentre 

A[3][5] *B[3][7],A[4][1] * B[4][4],A[2][3] *B [2] [9] 

non sono moltiplicazioni possibili. Per moltiplicare 
due matrici dobbiamo prima considerare ogni riga 
della matrice A come un vettore, in questo caso di tre 
elementi: aRigal(all, al2, al3); aRiga2(a21, a22, 
a33); aRiga3(a31, a32, a33) e ogni colonna della 
matrice B come un vettore bColonnal (bll,b21,b31); 
bColonna2(b21,b22,b23); bColonna3(b31,b32,b33). 
A questo punto moltiplichiamo i vettori nel seguen- 
te modo: il primo vettore della matrice A (aRigal) 
con il primo vettore della matrice B (bColl), il primo 
vettore della matrice A (aRigal) con il secondo vet- 
tore della matrice B (bCol2), il primo vettore della 
matrice A (aRigal) con il terzo vettore della matrice 
B (bCol3); e così via per ogni riga (o vettore) di A. Lo 
schema in Fig. 2 indica esattamente come eseguire 
la moltiplicazione matriciale. 
Quel puntino che vedete fra ogni vettore dentro la 
matrice risultato, è una speciale operazione mate- 
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Fig. 2: Moltiplicazione matriciale. 

matica detta moltiplicazione vettoriale, e significa 
che bisogna eseguire questo tipo di operazione: 

aRigal * bColl =all *bll +al2* b21 + al3 * b31 

Iniziamo finalmente a tradurre in codice C# quanto 
detto fino ad ora, scrivendo una funzione che effet- 
tui una moltiplicazione fra due matrici 4x4: 




In realtà non avremo quasi mai bisogno di scrivere le 
nostre funzioni di moltiplicazione fra matrici in C#, 
perché grazie alla libreria D3DX, DirectX espone 
moltissime utili funzioni per operare su matrici (ad 
esempio Matrix.MultiplyO per moltiplicare due ma- 
trici; Matrix.RotateXO per rotazioni lungo l'asse X; 
Matrix.ScaleQ per le proporzioni, ecc). Ora scopria- 





MATRICI 
IDENTITÀ 

Una matrice particolare 
è quella di identità che 
è un po' come il 
numero 1 nella 
moltiplicazione, ossia 
ha la particolarità che, 
quando moltiplicata 
per un vettore, 
restituisce come 
risultato lo stesso 
vettore per la quale 
era stata moltiplicata, 
senza alterarlo in alcun 
modo. Una matrice 
identità è composta da 
tutti zeri, tranne una 
riga diagonale di uno, 
come mostra la figura 
sotto. È bene, quando 
usiamo le matrici di 
DirectX in oggetti più 
complessi, inizializzarle 
sempre con matrici 
identità, e quindi 
neutre (il luogo ideale 
per effettuare ciò è 
dentro il costruttore di 
una classe). 
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Matrice identità 3x3. 
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Fig. 3: Semplice esem- 
pio di trasformazione. 



I QUATERNIONI 

Oltre all'uso delle 

matrici, esiste anche 

un altro modo in 

DirectX per muovere 

gli oggetti nello spazio 

3D: i quaternioni. Sir 

William Rowan 

Hamilton inventò i 

quaternioni 

(un'estensione dei 

numeri complessi) nel 

1843, ma solo nel 1985 

questi furono 

introdotti da Ken 

Shoemake nel campo 

della computer grafica. 

Per approfondimenti 

su questo argomento 

vi consiglio di visitare 

www.sigqraph.org 



mo finalmente in che modo tutta questa matemati- 
ca possa aiutare i programmatori 3D per effettuare 
delle trasformazioni come ad esempio quella rap- 
presentata in Fig. 3. Le matrici ci permettono di im- 
magazzinare una serie di equazioni, in modo che 
quando un vettore è moltiplicato per una matrice, 
otteniamo come risultato un vettore "trasformato". 
Questo è molto importante perché avremo bisogno 
di applicare ogni sorta di trasformazione (rotazioni, 
traslazioni, ecc) alle nostre coordinate 3D. Quindi 
tutto ciò di cui abbiamo bisogno è individuare la 
matrice di queste trasformazioni e moltiplicarla poi 
per i nostri vettori o coordinate 3D ottenendo i nuovi 
vettori e le coordinate. Senza scendere nel dettaglio 
matematico e dando quindi sempre per scontato 
che si conoscano le equazioni delle geometria anali- 
tica, le matrici per lavorare con coordinate omoge- 
nee nel nostro spazio 3D sono quelle rappresentate 
in Fig. 4. 
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Fig. 4: Matrici omogenee 4x4 di trasformazione. 

Concludiamo infine sottolineando come queste 
matrici 4x4 contengono nella parte superiore sini- 
stra 3x3 una sottomatrice per le informazioni sulle 
rotazioni e proporzioni/scaling, nei primi tre valori 
dell'ultima riga le informazioni per le traslazioni, e 
nell'ultima colonna i valori 0,0,0,1 (questo perché 
vogliamo che il quarto elemento dei nostri vettori 
4D omogenei resti invariato durante le moltiplica- 
zioni: deve sempre essere uguale ad uno). Tradu- 
cendo in codice quanto detto fino ad ora, potremmo 
a questo punto iniziare a sviluppare una classe (che 
amplieremo nei prossimi articoli) nella quale inca- 
psulare le funzioni che possono esserci utili durante 
lo sviluppo di applicazioni 3D con DirectX: 

public class MyUtility 

{ #region Funzioni Matriciali 

public bool MuoviOggetto(float scalaX, float scalaY, 
float scalaZ, int angleX, int angleY, int angleZ, float 
posX, float posY, float posZ, Device dev) 
{ //Variabili di appoggio 
float CosRx; 
float CosRy; 

float CosRz; 

float SinRx; 



float SinRy; 


float SinRz; 


//Fine variabi 


di appoggio 


float rad = 3.14/180; 


//Valore di conversione gradi/radianti 


//La matrice che conterrà tutte le informazioni 

sulla trasformazione da eseguire 


Matrix TempMat; 


CosRx = Math 


Cos(angleX * rad); 


CosRy = Math 


Cos(angleY * rad); 


CosRz = Math 


Cos(angleZ * rad); 


SinRx = Math.Sin(angleX * rad); 


SinRy = Math.Sin(angleY * rad); 


SinRz = Math.Sin(angleZ * rad); 


TempMat. Mll 


= (scalaX * CosRy * CosRz); 


TempMat. M12 


= (scalaX * CosRy * SinRz); 


TempMat. M13 


= -(scalaX * SinRy); 


TempMat. M21 


= -(scalaY * CosRx * SinRz) + 

(scalaY * SinRx * SinRy * CosRz); 


TempMat. M22 


= (scalaY * CosRx * CosRz) + 

(scalaY * SinRx * SinRy * SinRz); 


TempMat. M23 


= (scalaY * SinRx * CosRy); 


TempMat. M31 


= (scalaZ * SinRx * SinRz) + 
(scalaZ * CosRx * SinRy * CosRz); 


TempMat. M32 


= -(scalaZ * SinRx * CosRz) + 

(scalaZ * CosRx * SinRy * SinRz); 


TempMat. M33 


= (scalaZ * CosRx * CosRy); 


TempMat. M41 


= posX; 


TempMat. M42 


= posY; 


TempMat. M43 


= posZ; 


TempMat. M44 


= 1; 


Applico la matrice risultante al device di disegno 


dev.Transform. World = TempMat; // } 


#endregion } 



TRAIUSFORMATION 
PIPELINE 

Ora che abbiamo compreso come avvengono le tra- 
sformazioni, studiamo cosa accade in Direct3D. 
Il primo passaggio, come mostra la Fig. 5 è quello 
dell'inserimento (nel vertex buffer) dei nostri vertici 
attraverso le loro coordinate iniziali. Dopo di che 
avviene un processo di trasformazioni che si conclu- 
derà con la rasterizzazione su schermo del nostro 
spazio. Quello che abbiamo fatto nell'articolo prece- 
dente è stato proprio questo, ignorando per intero il 
processo di trasformazioni (chiamato simpatica- 
mente da Microsoft Tmnsformation Pipeline, ossia 
tubo delle trasformazioni). In questo processo si 
possono però applicare 3 matrici 4x4 che sono 
rispettivamente la World Matrix, la View Matrix e la 
Projection Matrix. La World Matrix indica le trasfor- 
mazioni che avvengono nel nostro mondo (ad 
esempio la rotazione vera e propria dei nostri ogget- 
ti 3D all'interno delle coordinate spaziali). La View 
Matrix specifica le trasformazioni dovute dallo spo- 
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stamento del nostro punto di osservazione dello 
spazio (ossia specifica la posizione e l' orientamento 
della telecamera virtuale che si muove nello spazio e 
attraverso la quale noi vediamo le scene rappresen- 
tate sullo schermo). La Projection Matrix serve infi- 
ne per passare dalle coordinate 3D virtuali (cattura- 
te dalla telecamera) alle vere coordinate 2D fìsiche 
dello schermo. Come si vede dal disegno qui sopra, 
un ultimo passaggio è presente nella nostra Trans- 
formation Pipeline, ossia il "Clippinge Viewport Sca- 
ling", responsabile della selezione dei vertici che si 
vedranno sul nostro schermo (ad esempio i vertici 
posti davanti alla telecamera) rispetto a quelli da 
scartare (vertici posti dietro la telecamera o fuori dal 
suo angolo di visuale): la geometria non visibile può 
essere scartata (anzi, deve esserlo per motivi di per- 
formance) perché non contribuirà alla rappresenta- 
zione finale sullo schermo. 



EFFETTUARE 
TRASFORMAZIONI 

Abbiamo appena visto come tutti i vertici in Di- 
rect3D passino attraverso la Transformation Pipe- 
line e siano sottoposti quindi a tre diverse trasfor- 
mazioni. Per inserire le tre matrici di trasformazione 
che verranno usate da Direct3D in questo processo 
si usano le proprietà della classe Device. Transform: 

device. Transform. World = [prima matrice 4x4]; 
device. Transform. View = [seconda matrice 4x4]; 
device. Transform. Projection = [terza matrice 4x4]; 

Fin qui tutto dovrebbe essere chiaro. Prima di vede- 
re quali specifiche matrici dovremo usare, è neces- 
sario chiarire il fatto che mentre la World Matrix, in 
una applicazione che usa dinamicamente la grafica 
3D, sarà in continuo aggiornamento per rispecchia- 
re i movimenti degli oggetti nello spazio, e la View 
Matrix sarà aggiornata per rispecchiare lo sposta- 
mento dell'osservatore nel mondo virtuale, la matri- 
ce di Projection non viene mai generalmente modi- 
ficata, perchè i rapporti fra il mondo 3D e la sua rap- 
presentazione sullo schermo 2D sono sempre gli 
stessi (a meno di non voler creare dei voluti effetti di 
distorsione e alterazione della prospettiva). 



WORLD MATRIX 

Una World Matrix non è altro che una matrice 4x4 
che contiene le informazioni riguardanti lo scaling, 
le traslazioni e rotazioni, che abbiamo visto poco fa, 
da applicare al nostro mondo 3D. Come già detto, 
D3DX contiene molte funzioni utilissime che ci 
risparmieranno di scrivere codice per il popolamen- 
to manuale delle nostre matrici. Ad esempio la fun- 



zione Matrix. RotationY accetta come parametro 
l'angolo di rotazione e restituisce una matrice 4x4 
che effettuerà questa trasformazione. Fra le utilissi- 
me funzioni di questa classe ricordiamo: 

Matrix.RotationX 

Matrix.RotationY 

Matrix.RotationZ 

Matrix.Scale 

Matrix. Translate 

Matrix.RotationYawPitchRoll 

MatrixAffineTransformation 

Inoltre, D3DX si preoccupa anche di fornirci i meto- 
di per lavorare con le matrici come ad esempio: 

Matrix.Multiply 

Matrix.Equals 

Matrix.Invert 



VIEW MATRIX 

Creare la View Matrix consiste nel descrivere l'orien- 
tamento e la posizione corrente della nostra teleca- 
mera virtuale come un nuovo sistema di coordinate. 
Possiamo effettuare ciò specificando tre vettori che 
rappresenteranno gli assi X, Ye Z di questo sistema 
come mostrato in Fig. 5. Questi tre vettori prendono 
anche il nome di Vettore Right (X), Vettore Up (Y) e 
Vettore Look (Z). Ci sono numerosi modi per calcola- 
re valore di questi vettori, 
compreso l'uso di quater- 
nioni e altri complessi siste- 
mi matematici, ma per 
quanto ci concerne è suffi- 
ciente usare una funzione di 
D3DX che prende in input i 
tre vettori Right, Up e Look 
definiti come sempre attra- 
verso una coordinata 3D: 




COSA C'È 
DIETRO 

BEGIMSCEMEO 
ED ENDSCENEQ 

BeginSceneQ fa si che 
il sistema (Direct3D) 
controlli le sue 
strutture di dati 
interne, la 
disponibilità e la 
validità delle superfici 
di rendering ed 
imposta infine un f lag 
per segnalare che è in 
atto il disegno di una 
scena. EndSceneQ 
ripristina questo flag, 
effettua un f lush dei 
dati di disegno 
immessi e verifica che 
le superfici di disegno 
siano corrette. 
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Fig. 5: Trasformation Pipeline. 



Matrix. LookAtLH(new Vector3(0.0f, 3,0f,-5,0f), 

new Vector3(0.0f, O.Of, O.Of), 

new Vector3(0.0f, l.Of, O.Of)); 



PROJECTION MATRIX 

Come già detto questa matrice serve per trasforma- 
re (prospetticamente) la geometria 3D in geometria 
2D per poterla disegnare sul nostro schermo in due 
dimensioni: se ad esempio su schermo vediamo gli 
oggetti distanti più piccoli di quelli vicini è grazie 
all'uso di questa matrice. Per costruire questa matri- 
ce è necessario specificare un angolo di vista (FoV- 
Field OfView), un aspect ratio, un piano di clipping 
vicino e un piano di clipping lontano. La funzione 
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Fig. 6: Vettori Up, Look 
e Right della View 
Matrix. 
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D3DX che restituisce una matrice di questo tipo è: 

Matrix. PerspectiveFovLH((float)Math. PI / 4, l.Of, l.Of, 

100. Of); 

L'angolo di vista è importante per stabilire se la geo- 
metria che si trova non esattamente di fronte a noi 
rientrerà nella nostra visuale o meno. 



Piano vicino 




Fig. 7: Raffigurazione della Projection Matrix. 




Fig. 8: Sequenza di 
immagini tratta dal 
nostro programma in 
esecuzione. 



Il parametro Aspect Ratio non è altro che l'altezza 
della superficie sulla quale disegniamo diviso per la 
sua larghezza. I piani di clipping servono per scarta- 
re la geometria che rispetto alla telecamera risulta 
essere troppo vicina (da problemi di rendering: se 
un punto si trova nella stessa coordinata Z di 
profondità avvengono delle divisioni per zero che 
mandano in errore l'intero sistema) o troppo lon- 
tana (inutile rappresentare qualcosa che non è visi- 
bile o sarebbe ridotto a meno di un pixel). 



IL MOSTRO ESEMPIO 

Dopo tanta teoria, è finalmente arrivato il momento 
in cui vediamo ripagati i nostri sforzi. Nella funzione 
RenderO del progetto del precedente articolo, subito 
dopo la chiamata a device.BegineSceneO inseriamo 
una nuova funzione che useremo per applicare tutte 
le trasformazioni che vogliamo. Chiameremo la fun- 
zione AggiornaMatrici e sarà così semplicemente 
implementata: 

private void AggiornaMatrici () 

{ // WORLD MATRIX: ruotiamo continuamente l'oggetto, 
device. Transform. World = Matrix. RotationAxis( 

new Vector3((float)Math.Cos(Environment.TickCount 
/ 250.0f),l,(float)Math.Sin(Environment.TickCount 

/ 250. Of)), Environment.TickCount/ 3000. Of ); 

// VIEW MATRIX: specifichiamo i tre vettori per 

questa matrice, 
device. Transform. View = Matrix. LookAtLH( new 
Vector3( O.Of, 3.0f,-5.0f ), new Vector3( O.Of, O.Of, O.Of ), 

new Vector3( O.Of, l.Of, O.Of ) ); 

// PROJECTION MATRIX: usiamo un FoV di p-greco 

quarti (scelta comune), 
// un aspect ratio che indichi l'uso di un quadrato 

(altezza / larghezza = 1), e i due piani di 
// clipping posizionati ad una distanza di 1 e 100. 
device.Transform. Projection = Matrix. PerspectiveFovLH( 
(float)Math.PI / 4, l.Of, l.Of, 100. Of ); } 



È infine anche importante impostare alcune pro- 
prietà della classe RenderStates, cosa che faremo 
dentro la funzione OnResetDeviceQ: 

public void OnResetDevice(object sender, EventArgs e) 



{ 



Device dev = (Device)sender; 
// Abilitiamo lo ZBuffer 
device. RenderState.ZBufferEnable = true; 
// Disabilitiamo il Culling 
dev.RenderState.CullMode = Culi. None; 
// Disabilitiamo le luci: i vertici hanno già i loro colori 
dev.RenderState.Lighting = false; 



} 



Prima di tutto impostiamo lo ZBuffer (come visto nel 
primo articolo, per disegnare oggetti 3D in DirectX 
bisogna settare la proprietà ZBufferEnable del devi- 
ce su true per abilitare la profondità della superficie 
di Rendering) . Abbiamo poi inoltre disabilitato il cul- 
ling e le luci: queste impostazioni fanno in modo 
che un oggetto 3D venga disegnato interamente 
(tutte le sue facce), e che avendo già dei propri colo- 
ri e non necessitando quindi di illuminazione ag- 
giuntiva, sia rappresentato così com'è. Vedremo più 
approfonditamente queste proprietà nel prossimo 
articolo, per ora prendiamole per buone e gustiamo- 
ci i risultati che abbiamo raggiunto attraverso le 
screenshot in Fig. 8 del progetto di questo articolo. Il 
codice affrontato in questo articolo è disponibile in 
formato zip nel CD allegato alla rivista. Il progetto è 
creato con Visual Studio .NET 2003, in caso non 
disponiate di quest'ultima versione potete tranquil- 
lamente prendere da questo zip i file .cs e creare un 
progetto con Visual Studio .NET 1. Noterete che 
codice è leggermente diverso (e più completo rispet- 
to alle estrapolazioni che abbiamo messo qui), ma la 
struttura della parte DirectX, che è quella che a noi 
interessa, è l'esatta copia. La novità principale sta 
nel fatto che invece di aver disegnato un solo trian- 
golo (come la volta precedente) abbiamo rappresen- 
tato una piramide usando quindi un totale di 6 
triangoli (due per la base quadrata, e quattro per i 
lati obliqui). Sono certo che troverete questa parte 
semplice ed interessante: sono i nostri primi passi 
nella navigazione degli spazi 3D e nella scoperta 
degli oggetti a tre dimensioni. 



CONCLUSIONI 

In questo articolo abbiamo imparato molto: dopo 
aver disegnato degli oggetti nello spazio, sappiamo 
ora anche come muoverli ed animarli. Ci accorgia- 
mo subito però che questa grafica è un po' irreale, 
troppo astratta. . . Nel prossimo articolo impareremo 
come aumentare il realismo attraverso l'uso delle 
luci e dei materiali. 

Carlo Federico Zoffoli 



* 80/ Luglio - Agosto 2004 



http://www.ioprogrammo.it 




Delphi 



Ancora OOP, interfacce ed eccezioni 



i 



T CORSI BASE 




Corso di Object 



Pascal 



parte ultima 



In questa puntata dedicata a Delphi, concluderemo con 

un approfondimento sull'ereditarietà e la nozione di interfaccia. 

Infine gestiremo gli errori con le eccezioni. 



Siamo giunti al nostro ultimo appuntamento 
con questo corso base sul linguaggio di pro- 
grammazione di Delphi. Nella puntata scorsa 
avevamo introdotto una serie di concetti nuovi rela- 
tivi all'OOP: si è parlato di ereditarietà, cioè della 
possibilità da parte di una nuova classe (la classe 
derivata) di estendere il comportamento di una clas- 
se già esistente (la classe madre). Abbiamo poi intro- 
dotto la caratteristica del polimorfismo, cioè la capa- 
cità, oltre che di estendere, anche di alterare il com- 
portamento di alcuni metodi della classe madre, tra- 
mite l'overriding (nel caso del binding dinamico) o 
l'hiding (se è binding statico). Se vi ricordate, aveva- 
mo elencato due possibili modificatoti per indicare 
l'ambito di utilizzabilità di una proprietà, di un 
metodo, o di una variabile di una classe. Il modifica- 
tere public stava ad indicare che qualunque codice 
dove fosse possibile usare la classe aveva accesso a 
quel membro, mentre private indicava che sola- 
mente il codice all'interno dello stesso modulo Pa- 
scal (file, in sostanza) poteva accedere alla proprietà 



Unita!. pas Unita2.pas 












TMiaClasse = class 

datoli atring; 
protectetl 

dato2: String; 

property MiaProp: String read dato2; 
procedure list LoUns (pacami; Integer) ; 
end; 


/.■' Classe derivata ijn un Modulo diverso 
TAltraDerivata = class (TMiaClasse) 

function ■..-.;■■■ -ovoDue : String; 




1 ■"'lasse non derivata in altro modulo 
TAltraClasse = class 

function UnaFunzione: String; 




TMiaDecivata = class (TMiaClaase) 

procedure KetodoHuovo; 
end; 




fuiiet.ion TAltraDerivata.MetodoNuovoDue: String; 

MetodoUno(123) ; 
Console. Writeln(datol) ; 

Console. Mriteln (dato2 ) ; 
Result:= MiaProp; 
end; 

function TAltraClase. UnaFunzione: String; 

miaclasse.MetodoUno (123); 
Console. Writeln(miaclasse . datol) ; 
Console. TOr:iteln(miaclasBe.dato2) ; 

R.asult:= miaciasse.MiaProyj; 




// . . . implementazione . . . 
procedure THiaDerivata.MetodaMuovo; 

MetotìoUno(123) ; 
Console. Writeln (datai) ; 
Console. Writeln (dato2 ) ; 
Console. Wri tei n (MiaProp) : 









Fig. 1: Uno scenario esemplificativo dei vari livelli di visibilità. 



o metodo. Fermo restando quanto detto finora, 
adesso che conosciamo la possibilità di derivare 
classi nuove da classi esistenti, possiamo anche par- 
lare di un terzo ambito di visibilità detto protected. 



LA VISIBILITÀ 
PROTECTED 

La distinzione tra public e private serve per mettere 
in atto la caratteristica dell'incapsulamento, di cui 
avevamo già parlato nel quinto articolo dedicato a 
questo corso: grazie alla possibilità di avere dei 
membri privati, il programmatore di una classe può 
arrogarsi il diritto di nascondere l'implementazione 
delle funzionalità dell'oggetto a chi lo utilizzerà, 
esponendo solo quelle caratteristiche che vengono 
offerte come pubbliche. Ricorderete, dal paragrafo 
precedente, che tutto il codice presente nello stesso 
modulo avrà la facoltà di accedere ai membri priva- 
te, ma nessun altro! Nei confronti dell'ereditarietà, 
però, si viene a porre 
seguente problema: è ve- 
ro che dati e metodi pri- 
vati s'intendono interni e 
dunque non mi interessa 
renderli visibili fuori dal 
modulo, ma se una classe 
eredita da un'altra po- 
trebbe essere utile ren- 
derle disponibili anche i 
meccanismi interni di 
elaborazione (dati e me- 
todi). Ecco che entra in 
gioco il nuovo livello di 
visibilità protected, che 
implica, in sostanza, la 
stessa esposizione all'e- 
sterno di private (quindi 
solo nel modulo), ma of- 
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TPersistentObject 

Normalmente quando 

si crea una classe che 

implementa 

un'interfaccia, come 

classe madre si indica 

TPersistentObject od 

una sua derivata. 

Questo perché tutte le 

interfacce derivano 

dall'interfaccia 

llnterface, la quale 

prevede tre metodi che 

sono già implementati 

in TPersistentObject, 

sollevando così il 

programmatore dal 

doverli ridefinire, 

trattandosi tra l'altro 

di funzionalità 

sistemistica legata alla 

gestione dei 

riferimenti agli 

oggetti. 



fre in più anche la visibilità a tutte le classi derivate 
(nel modulo e fuori). Diamo un'occhiata allo scena- 
rio presentato nella Fig. 1. Abbiamo una classe chia- 
mata TMiaClasse che espone un metodo ed una 
proprietà pubblici, rispettivamente MetodoUno e 
MiaProp, una variabile privata detta datol, ed una 
protetta di nome dato2. A questo punto, creiamo 
una classe derivata nello stesso modulo {TMiaDeri- 
vata): questa avrà visibilità di tutti i membri della 
classe madre, compresi quelli protetti e privati. In 
realtà, non cambierebbe nulla anche se non fosse 
una derivata, dato che il motivo per cui ha visibilità 
totale è perché fa parte dello stesso modulo. 
Ma veniamo ora alle altre due classi, definite questa 
volta in una unità separata (Unit2.pas): la classe 
TAltraClasse non deriva da TMiaClasse e di conse- 
guenza potrà vedere - come abbiamo già studiato in 
passato - solamente i membri pubblici di TMiaClas- 
se (miaclasse nell'esempio rappresenta un'ipotetica 
variabile di tipo TMiaClasse precedentemente ini- 
zializzata). Il secondo tipo {TAltraDerìvata) presente 
nel secondo modulo, però, è derivato da TMiaClas- 
se: questo gli dà visibilità anche del membro dato2, 
definito come protected. Resta comunque irraggiun- 
gibile la variabile privata datol. Nella figura vedete 
evidenziate in rosso grassetto le righe che referen- 
ziano dati o metodi non visibili. Quando usare pri- 
vate e protected? Qual è l'utilità di protected? 



LE INTERFACCE 

L'ultimo argomento che abbiamo trattato la volta 
scorsa era relativo ai metodi abstract, che si possono 
definire in alcune classi per evitare di dare un'imple- 
mentazione a funzionalità che assumono senso solo 
in specializzazioni della classe stessa. Ripensando 
all'esempio sulla geometria che stiamo portando 
avanti, se è vero che può essere utile definire una 
classe generica TFigura, perché ci sono delle caratte- 
ristiche comuni a tutte le figure geometriche che 
così dichiariamo una volta per tutte, è anche vero 
che un probabile metodo Disegna di tale classe (è 




normale che una figura geometrica si possa dise- 
gnare!) non può essere implementato se non nelle 
derivate che rappresentano figure più specifiche (ad 
esempio TRettangolo o TEllisse). Ora, se prediamo il 
significato del concetto abstract legato ad un meto- 
do e lo estendiamo a tutto ciò che la classe espone, 
arriviamo vicini all'idea di interfaccia (interface). 
Essa è - in senso molto lato - una classe che ha solo 
metodi e proprietà astratti. Notate che mancando 
interamente di implementazione, un'interfaccia 
non potrà avere variabili membro! Una classe che 
implementa (implements) un'interfaccia si obbliga a 
dare una definizione a tutti i metodi e tutte le pro- 
prietà che tale interfaccia richiede. La sintassi per 
dichiarare un'interfaccia è la seguente, tratta dall'ap- 
plicazione d'esempio allegata all'articolo (che vede- 
te in esecuzione in Fig. 2): 




Fig. 2: L'applicazione d'esempio in esecuzione. 



Mentre, per affermare di voler implementare un'in- 
terfaccia, una classe deve aggiungere tale interfaccia 
(o più di una volendo) al nome della classe madre, in 
questo modo: 

TImmagine = class(TInterfacedObject, IDisegnabile) 
private 

picture: TBitmap; 
public 
constructor Create(filename: String); 
procedure Disegna(gdc: TCanvas); overload; 
procedure Disegna(gdc: TCanvas; inizio: TPunto); 

overload; 
procedure Disegna(gdc: TCanvas; x: Integer; y: 

Integer); overload; 
end; 

Dovete pensare ad un'interfaccia come ad un obbli- 
go, che viene assunto da chi la implementa, di dare 
funzionalità ai metodi e proprietà dichiarati. Ma a 
che ci serve dunque l'interfaccia e in che senso è 
diversa da una classe astratta? 



IMPLEMENTARE 
ED EREDITARE 

Cominciamo dalla seconda domanda. Estendere 
una classe con metodi astratti significa sì impegnar- 
si ad implementare tali metodi, ma fondamental- 
mente significa ereditare tutta la funzionalità che 
tale classe mi mette a disposizione. Prendiamo il 
caso di TFigura che riporto qui sotto: 
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TFigura = class(TInterfacedObject, IDisegnabile) 

private 

_useDefColor: Boolean; 
_useDefSpessore: Boolean; 

_color: TColor; 

_spessore: Integer; 
_riempi: Boolean; 

procedure _SetSpessore(valore: Integer); 
procedure _SetColore(colore: TColor); 
protected 
function _CalcolaPerimetro: Extended; virtual; abstract; 
function _CalcolaArea: Extended; virtual; abstract; 
procedure _DisegnaFìgura(gdc: TCanvas; inizio: 

TPunto); virtual; abstract; 

public 

property Colore: TColor read _color write _SetColore; 
property Spessore: Integer read _spessore write 

_SetSpessore; 

property Riempi: Boolean read _riempi write _riempi; 
property Perimetro: Extended read _CalcolaPerimetro; 
property Area: Extended read _CalcolaArea; 
procedure Dìsegna(gdc: TCanvas); overload; 
procedure Dìsegna(gdc: TCanvas; inizio: TPunto); 

overload; 
procedure Disegna(gdc: TCanvas; x: Integer; y: 

Integer); overload; 
end; 

è vero che la definizione dell'argomento di disegno è 
lasciato alle sottoclassi (metodo astratto JDisegna- 
Figura), ma è altresì vero che tutta la funzionalità di 
gestione di spessore, colore e riempimento è porta- 
ta a termine all'interno di questa classe generica. 
TFigura non è quindi solo un contratto da rispetta- 
re, bensì un bagaglio di codice già scritto che noi riu- 
tilizziamo nel definire, per esempio, TRettangolo, 
TEllisse, etc. Se però pensiamo al fatto che TFigura 
implementa IDisegnabile, qui non possiamo più dire 
che questa caratteristica offra funzionalità ereditata 
a TFigura: semplicemente, la classe sta dichiarando 
al mondo il proprio impegno a ridefinire e dare 
un'implementazione ai metodi che IDisegnabile 
prevede. Non ci resta che tornare alla prima questio- 
ne: a che prò? Nello scrivere il codice, l'interfaccia ci 
torna comodo come segnaposto per tutte quelle 
classi - ignote in fase di compilazione - che la imple- 
mentano. Dichiarando una variabile di tipo IDise- 
gnabile, io potrò assegnare a tale variabile un ogget- 
to di tipo TImmagine o un qualsiasi oggetto derivato 
da TFigura. Ecco così che nell'applicazione di que- 
sto mese dichiaro l'array che contiene tutto quello 
che l'utente chiede di disegnare sulla finestra: 

figures: array of IDisegnabile; 

e il metodo di risposta all'evento OnPaint, che dise- 
gna gli oggetti di tale array, si baserà sulla dichiara- 
zione di IDisegnabile per invocare il metodo Dise- 



gna, sicuro del fatto che è disponibile in tutti gli 
oggetti che implementano tale interfaccia: 

procedure TForml.FormPaint(Sender: TObject); 
var 

i: Integer; 
begin 

for i:= to Length(figures) - 1 do 

begin 
figures[i].Disegna(Canvas,origins[i]); 

end; 
end; 




Per un esempio un po' più completo 
delle possibilità di assegnazione ad 
una variabile dichiarata come inter- 
faccia fanno testo i metodi Nuova- 
Immagine 1 Click e NuovaFigural- 
Click. Questi vengono invocati in ri- 
sposta alla selezione dei menu File-> 
Nuova Immagine e File->Nuova Fi- 
gura, e il loro obiettivo è di creare un 
oggetto TImmagine con il bitmap 
richiesto (NB solo i file BMP sono 
supportati!) o un'istanza di una de- 
rivata di TFigura in base al form 
compilato dall'utente (vedi le Fig. 3, 
4 e 5). 
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Fig. 3: La dì a log box usata da 
NuovaFiguralClick in modalità Ellisse. 



Nuova Immagine 



Il codice dei due metodi appena 
menzionati ci porta dritti al nostro 
nuovo (ed ultimo) argomento. Avre- 
te certamente notato una parola 
chiave (try) di cui ancora non abbia- 
mo detto nulla, ma che ricorderà 
qualcosa a chi ha già programmato 
in C++ Java (lo stesso costrutto è 
oggi presente anche in VB.NET e 
C#). Si tratta di uno statement con 
cui si mette in moto il meccanismo 
di gestione delle eccezioni (excep- 
tion handling). Le eccezioni sono 
delle condizioni anomale che si veri- 
ficano durante l'esecuzione dei 
nostri programmi. Sono determina- 
te normalmente da errori causati da 
input errati, cattivo uso delle classi 
di cui ci si è avvalsi, o semplicemen- 
te da uno stato del sistema inade- 
guato agli obiettivi del programma 
(memoria insufficiente, disco o dispositivo non pre- 
sente, e via dicendo). Il verificarsi di una di queste 
eccezioni, normalmente, termina il programma in 
esecuzione, ritornando il controllo al sistema opera- 
tivo: se però, prevedendo quali tipi di eccezioni 
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Fig. 4: La dialog box usata da 
NuovaFiguralClick in modalità Quadrato. 
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Fig. 6: La libreria di clas- 
si lancia un'eccezione e 
il form principale la cat- 
tura. 



potrebbero aver luogo, decidiamo di gestire noi l'e- 
ventuale problema e di permettere così al nostro 
software di procedere rimediando all'anomalia, 
allora dobbiamo includere le istruzioni a fronte delle 
quali possono insorgere le difficoltà in un blocco 
trylexcept, come segue 

try 

// istruzioni potenzialmente problematiche 

except 
// gestione delle eccezioni, se presenti 

end; 

La sezione except contiene una struttura sintattica 
simile al case, con una serie di on seguiti dal tipo di 
eccezione che intendiamo gestire nella sezione rela- 
tiva. 

try 
except 

on EZeroDivide do GestisciDivisionePerZero; 

on EOverflow do GestisciOverflow; 

on EMathError do GestisciMathErrorGenerico; 
end; 

Sappiate che, di fatto, le eccezioni non sono altro 
che istanze di classi che derivano da Exception. 
Anche noi possiamo, in maniera molto semplice, 
creare delle eccezioni personalizzate 



raise EGeometryException.Create('La base deve 

essere > 0'); 

Osservate anche l'interessante caso del costruttore 

di TImmagine 
constructor TImmagine. Create(filename: String); 
begìn 

try 

picture:= TBitmap.Create(); 
picture.LoadFromFile(filename); 
except 
on e: Exception do raise 

EGeometry Exception. Create(e.Message); 
end; 
end; 

in cui noi gestiamo un'eccezione generica lancian- 
done un'altra nostra. Notate la sintassi alternativa 
utilizzata con lo statement on, in cui l'oggetto di ec- 
cezione (di tipo Exception) viene assegnato ad una 
variabile (e), per poterne poi utilizzare proprietà e 
metodi (nell'esempio viene richiamata la proprietà 
e.Message che restituisce il messaggio di descrizione 
del problema). Infine, il form principale del pro- 
gramma d'esempio si premerà di catturare le even- 
tuali eccezioni EGeometryException lanciate dalla li- 
breria di figure geometriche e di gestirle invitando 
l'utente ad immettere dei valori corretti negli appo- 
siti form (vedi Fig. 6). 
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EGeometryException = class(Exception); 

Anche se la mia eccezione in questo caso non ag- 
giunge nulla di nuovo alla funzionalità di base di 
Exception. La definizione qui sopra mi permette di 
gestire in una sezione on separata le anomalie ri- 
scontrate e registrate specificatamente dalle mie 
classi. Quando stiamo disegnando una libreria ad 
oggetti, possiamo infatti decidere di gestire determi- 
nate condizioni d'errore attraverso il lancio di ecce- 
zioni verso il codice che invoca le nostre classi. Par- 
tendo sempre dall'applicativo esemplificativo sulle 
figure geometriche, lo spessore minore di 1, o una 
base, altezza o raggio minori o uguali a sono pro- 
blemi su cui il codice di implementazione interno 
della classe non ha modo di intervenire se non av- 
vertendo l'utente trasmettendogli un'eccezione. Se il 
tipo d'eccezione che lancio è un tipo mio specifico, 
potrò conseguentemente gestire la situazione in 
maniera più consona e particolareggiata in un bloc- 
co on dedicato al mio tipo di oggetto derivato da 
Exception. Qui vedete come la classe TRettangolo 
lancia un'eccezione se la base viene impostata su un 
valore non idoneo 

if n > then 

b:= n 

else 



CONCLUSIONI 

Giunti fino qui, dovreste avere una visione abba- 
stanza completa del linguaggio Object Pascal. A cor- 
redo di questo articolo trovate una versione evoluta 
dell'applicazione per disegnare figure geometriche 
su un canvas. Questa versione definisce un'interfac- 
cia di base IDisegnabile, implementata da TImmagi- 
ne (per disegnare file bitmap) e TFigura (classe 
astratta che fa da base per TRettangolo e TEllisse - a 
loro volta, da TRettangolo deriva TQuadrato e da 
TEllisse deriva TCerchio). Nel codice, trovate esempi 
di lancio di eccezioni (con raise) e cattura delle stes- 
se (trylexcept, ), così da avere un esempio pratico di 
quanto visto in questo ultimo appuntamento. Per 
poter apprendere davvero bene un linguaggio di 
programmazione è necessaria molta pratica ed 
esperienza: l'unico modo per ottenerle entrambe è 
scrivere codice, per cui non abbiate paura di metter- 
vi subito al lavoro e realizzare le vostre idee sfruttan- 
do le conoscenze di Object Pascal che avete acqui- 
sito. Nel box a lato trovate un paio di link utili come 
ispirazione per approfondire e fare, mentre per pic- 
coli dubbi e quesiti potete provare a scrivermi all'e- 
mail federico.mestrone@ioprogrammo.it, pazien- 
tando un po' per la risposta perché tempo libero è 
pochissimo! Buon proseguimento. 

Federico Mestrone 
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La tecnologia GDI+ del Framework .NET 



Grafica in VB.NET 

Continua il viaggio all'interno della tecnologia GDI+. 
Realizzeremo disegni e immagini con le problematiche legate 
al sistema di coordinate. 



Nel precedente articolo abbiamo introdotto 
la tecnologia GDI+ ed abbiamo visto come 
la prima operazione da compiere, per dise- 
gnare elementi grafici in una qualsiasi periferica di 
visualizzazione, consiste nell' ottenere un riferimen- 
to ad un oggetto Graphics. Un oggetto Graphics rap- 
presenta, in pratica, una superficie di disegno (non 
deve essere necessariamente una superficie visibi- 
le), normalmente l'area client di un oggetto Form. 
Tutti gli esempi di codice descritti nel precedente 
articolo assumevano che l'origine delle coordinate 
fosse nell'angolo superiore sinistro dell'area client, e 
che tutti i valori fossero espressi in pixel. L'oggetto 
Graphics consente di modificare le impostazioni 
predefinite permettendo di cambiare il sistema di 
coordinate. La seconda parte dell'articolo sarà in- 
centrata sulla gestione delle immagini di tipo raster 
e vettoriali. 



I SISTEMI 

DI COORDINATE 

In GDI+, quando si disegna un oggetto grafico (in- 
cluse immagini e testo), vengono utilizzati tre diffe- 
renti sistemi di coordinate: di ambiente, di pagina e 
di periferica, vediamoli in dettaglio. 

Il sistema di coordinate di ambiente (o complessi- 
vo) è il sistema utilizzato di default per modellare 
l'ambiente grafico. Tutte le coordinate che vengono 
passate ai metodi grafici sono espresse nel sistema 
di coordinate di ambiente. 

Il sistema di coordinate della pagina è il sistema 
utilizzato dalla superficie su cui si disegna: sia essa 
una form, un controllo o un documento da stampa- 
re. Di solito, l'origine e la scala di questo sistema 
coincidono con quelle del sistema di coordinate 
d'ambiente, ma questo non è obbligatorio. È possi- 
bile fissare l'origine del sistema in un punto qualsia- 
si della form. La conversione tra le coordinate del- 
l'ambiente e quelle della pagina viene definita tra- 
sformazione d'ambiente. 
Il sistema di coordinate della periferica è il sistema 



utilizzato dalla periferica fisica sulla quale avviene 
l'operazione di disegno. Se si disegna su schermo la 
periferica è la finestra, se l'output viene inviato alla 
stampante la periferica diventa il foglio. È possibile 
definire con precisione l'unità di misura del sistema 
(pollici,milrimetri, ecc), il rapporto tra l'asse vertica- 
le e quello orizzontale. La conversione tra le coordi- 
nate della pagina e quelle della periferica viene defi- 
nita trasformazione di pagina. 

Supponiamo di voler disegnare una linea retta, che 
colleghi due punti specificati da due coppie di coor- 
dinate, utilizzando il metodo DrawLine descritto 
nell'articolo precedente. In particolare vogliamo 
disegnare una linea di colore rosso che colleghi i 
punti di coordinate (1,1) e (100,100), il codice neces- 
sario è il seguente: 

Dìm OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Red) 
OggettoGrafico. DrawLine(OggettoPen, 1, 1, 100, 100) 
OggettoGrafico. Dispose() 

Con l'istruzione OggettoGrafi.co.DrawLine(Oggetto- 
Pen, 1, 1, 100, 100), i punti passati al metodo Draw- 
Line si trovano nello spazio di coordinate complessi- 
vo, per cui il risultato è quello riportato in Fig. 1. Fac- 
ciamo ora l'ipotesi di voler fare riferimento ad un 
sistema di coordinate la cui origine si trovi in un 
punto all'interno dell'area client, posto, per esem- 
pio, ad 80 pixel di distanza dal margine sinistro ed a 
70 pixel di distanza dall'estremità superiore. Tra i 
metodi che l'oggetto Graphics mette a disposizione 
per influire sulle modalità della trasformazione 
d'ambiente, possiamo utilizzare il metodo Transla- 
teTransform. Il metodo TranslateTransform permet- 
te di modificare l'origine del sistema di coordinate 
spostandola nei punti specificati come argomento. 
In questo modo, per disegnare lo stesso oggetto in 
una posizione differente, sarà sufficiente traslare l'o- 
rigine degli assiX-Fdi 80 unità nella direzione x e 70 
unità nella direzione y. 

OggettoGrafico.TranslateTransform(80, 70) 
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OggettoGrafico.DrawLine(OggettoPen, 1, 1, 100, 100) 

Il metodo RotateTmnsform permette di ruotare di 
un angolo qualsiasi, tutto ciò che viene disegnato 
sull'oggetto Graphics. Vogliamo, ad esempio, dise- 
gnare un rettangolo, utilizzando il metodo Draw- 
Rectangle ed applicargli una rotazione di 45 gradi, il 
codice sarà il seguente: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 

Dim OggettoPen = New Pen(Color.Red) 

'applico la rotazione di 45 gradi 

OggettoGrafico. RotateTransform(45) 

OggettoGrafico. DrawRectangle(OggettoPen, 100, 10, 100, 50) 

OggettoGrafico. Dispose() 

Utilizzando il metodo ScaleTransform, è possibile 
modificare la scala utilizzata, lungo i due assi, per 
disegnare sull'oggetto Graphics. I fattori di scala in 
direzione x ed y devono essere passati come argo- 
mento. Fino a quando utilizziamo pixel come uni- 
tà di misura, le coordinate della periferica corri- 
spondono alle coordinate della pagina. Per applica- 
re una trasformazione di pagina, la classe Graphics 
mette a disposizione le proprietà Pagellnit e Page- 
Scale. La proprietà PageUnit accetta un valore enu- 
merato GraphicsUnit per specificare un'unità di 
misura diversa dal pixel (valore di default per il 
video). Sono ammessi i valori: 

• Indi, indica come unità di misura il pollice. 

• Mìllimiter, indica come unità di misura il milli- 
metro. 

• Point, indica come unità di misura un punto 
della stampante, 1/72 di pollice. 

• Display, indica come unità di misura 1 / 75 di pol- 
lice. 

• Document, indica come unità di misura quella 
del documento, 1/300 di pollice: 

Vogliamo, ad esempio, disegnare una linea che col- 
leghi i punti di coordinate (0,0) e (20,50), dove il 
punto (20,50) si trova 20 millimetri a destra e 50 mil- 
limetri in basso rispetto al punto (0, 0), dovremo 
quindi scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoPen = New Pen(Color.Red) 
OggettoGrafico. PageUnit = GraphicsUnit. Millimeter 
OggettoGrafico. DrawLine(OggettoPen, 0, 0, 20, 50) 
OggettoGrafico. Dispose() 

Dopo aver eseguito questo codice, possiamo notare 
come lo spessore della linea disegnata sia aumenta- 
to. Questo effetto si ottiene poiché gli oggetti Pen 
(per default) hanno una larghezza di una unità, 
misurata rispetto alle coordinate della periferica. Per 
questo, adottando i millimetri come unità di misura, 



la linea è stata disegnata con un oggetto Pen largo 
un millimetro. Se vogliamo evitare questo effetto 
possiamo utilizzare le proprietà di sola lettura DpiX 
e DpiY che permettono di ottenere la risoluzione 
orizzontale e verticale, in modo da determinare 
valore da passare al costruttore dell'oggetto Pen: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
OggettoGrafico. PageUnit = GraphicsUnit. Millimeter 
Dim OggettoPen = New Pen(Color.Red, 1 / 

OggettoGrafico. DpiX) 
OggettoGrafico. DrawLine(OggettoPen, 0, 0, 20, 50) 
OggettoGrafico. Dispose() 

Infine, la proprietà PageScale permette di ridurre o 
ingrandire di un dato fattore le unità di misura glo- 
bali e quelle della pagina. 
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Fig. 3: Immagine clonata. 

GESTIONE 
DELLE IMMAGINI 

La tecnologia GDI+ prevede un sottoinsieme che è 
stato creato specificamente per mostrare ed elabo- 
rare tanto immagini raster (bitmap) che immagini 
vettoriali (metafile). I due oggetti più rilevanti per l'e- 
laborazione delle immagini sono: 

• La classe Image, classe base astratta, che forni- 
sce metodi per salvare e caricare immagini da 
disco, ed altre operazioni sulle immagini 

• La classe Bitmap, che deriva da Image, e con- 
sente di espanderne le funzionalità fornendo 
metodi aggiuntivi per modificare le immagini ra- 
ster e per accedere ai singoli pixel dell'immagi- 
ne. La classe Bitmap supporta numerosi formati 
di file, compresi BMP GIF, JPEG, PNG e TIFF. 

• La classe Metafile permette di espandere le fun- 
zionalità della classe Image fornendo metodi ag- 
giuntivi per salvare, caricare, modificare ed esa- 
minare immagini di tipo vettoriale (memorizza- 
te sotto forma di comandi e impostazioni di di- 
segno). La classe metafile supporta immagini 
memorizzate nei formati: WMP(Windows Meta- 
file), EMFfEnhanced Metafile), EMF+ 

In definitiva, per caricare e visualizzare un'immagi- 
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ne vettoriale, sono necessari un oggetto Graphics ed 
un oggetto Metaflle. Per visualizzare un'immagine 
raster, sono necessari un oggetto Graphics ed un 
oggetto Bitmap. Le classi Image e Bitmap apparten- 
gono al namespace System.Drawing, mentre la clas- 
se Metaflle appartiene al namespace System.Dra- 
wing. Imaging. 



IL METODO 
DRAWIMAGE 

L'oggetto Graphics mette a disposizione il metodo 
Drawlmage, che permette di visualizzare un'imma- 
gine ricevuta da un oggetto Metaflle o Bitmap passa- 
to come argomento. Esistono numerose versioni di 
overload (trenta) del metodo Drawlmage, quindi è 
possibile fornire argomenti in svariati modi. La ver- 
sione più semplice, accetta come argomenti l'imma- 
gine da mostrare a video e le coordinate dell'angolo 
superiore sinistro dell'area di destinazione. La prima 
operazione da compiere è quella di caricare un'im- 
magine in un oggetto Bitmap (o Metaflle), per que- 
sto possiamo utilizzare il relativo costruttore e scri- 
vere: 

Dim OggettoBitmap As New Bitmap("C:\MiaImmagine.jpg") 

In cui C:\MiaImmagine.jpg è il percorso completo 
del file contenente l'immagine da mostrare. Dopo la 
creazione dell'oggetto Bitmap, è necessario passare 
questo oggetto come argomento al metodo Draw- 
lmage insieme alle coordinate. Per disegnare l'imma- 
gine bitmap con l'angolo superiore sinistro in corri- 
spondenza di (50, 50) dobbiamo scrivere: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoBitmap As New Bitmap("C:\MiaImmagine.jpg") 
OggettoGrafico. DrawImage(OggettoBitmap, 50, 50) 
OggettoBitmap. Dispose() 
OggettoGrafico. Dispose() 

Un'altra versione del metodo Drawlmage riceve, 
come argomenti, un oggetto Bitmap contenente 
l'immagine da disegnare, ed un oggetto Rectangle, 
che permette di specificare il rettangolo in cui verrà 
tracciata l'immagine. Se le dimensioni del rettango- 
lo di destinazione non corrispondono alle dimen- 
sioni dell'immagine originale, l'immagine verrà ridi- 
mensionata ed adattata al rettangolo di destinazio- 
ne. Sfruttando questo comportamento ed utilizzan- 
do la proprietà Width dell'oggetto Bitmap che speci- 
fica la larghezza dell'immagine, e la proprietà Height 
dell'oggetto Bitmap che ne specifica l'altezza, pos- 
siamo ingrandire o comprimere un'immagine. Nel 
codice seguente definiamo tre rettangoli di di- 
mensioni diverse. Il primo rettangolo ha le stesse 
dimensioni dell'immagine, pertanto questa verrà di- 



segnata nelle sue dimensioni reali. Il secondo ret- 
tangolo avrà le dimensioni pari alla metà dell'imma- 
gine, pertanto l'immagine risulterà compressa. Il 
terzo rettangolo avrà le dimensioni pari al doppio 
dell'immagine, pertanto l'immagine risulterà in- 
grandita rispetto alle dimensioni originali. 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoBitmap As New Bitmap("C:\MiaImmagine.jpg") 
'definisce un rettangolo delle esatte dimensioni 

dell'immagine 
Dim RettangoloEsatto As New Rectangle(0, 0, _ 

OggettoBitmap. Width, OggettoBitmap. Height) 
'definisce un rettangolo delle dimensioni dimezzate 

dell'immagine 
Dim RettangoloCompresso As New Rectangle(50, 0, _ 

OggettoBitmap. Width / 2, OggettoBitmap. Height / 2) 
'definisce un rettangolo delle dimensioni uguali al 

doppio dell'immagine 
Dim RettangoloEspanso As New Rectangle(100, 0, _ 

OggettoBitmap. Width * 2, OggettoBitmap. Height * 2) 
OggettoGrafico. DrawImage(OggettoBitmap, 

RettangoloEsatto) 
OggettoGrafico. DrawImage(OggettoBitmap, 

RettangoloCompresso) 
OggettoGrafico. DrawImage(OggettoBitmap, 

RettangoloEspanso) 
OggettoBitmap. Dispose() 
OggettoGrafico. Dispose() 

Un'ulteriore versione del metodo Drawlmage per- 
mette di specificare, oltre al rettangolo di destinazio- 
ne, anche il rettangolo di origine. Il parametro relati- 
vo al rettangolo di origine permette di determinare 
quale porzione dell'immagine originale dovrà esse- 
re disegnata. Utilizzando ancora una volta le pro- 
prietà Width ed Height possiamo, quindi, ritagliare 
una parte dell'immagine originale. Anche in questo 
caso, se le dimensioni del rettangolo di destinazione 
non corrispondono alle dimensioni del rettangolo di 
origine, l'immagine verrà ridimensionata e adattata 
al rettangolo di destinazione. 



IL METODO CLONE 

La classe Bitmap mette a disposizione il metodo 
Clone, che permette la creazione di una copia di un 
oggetto Bitmap esistente. Il metodo Clone riceve co- 
me parametri: 

• Un oggetto Rectangle relativo al rettangolo di ori- 
gine, che permette di determinare quale porzio- 
ne della bitmap originale dovrà essere copiata. 

• Un valore di tipo PixelFormat che definisce il for- 
mato dei dati relativi al colore per ciascun pixel 
dell'immagine (in particolare definisce il nume- 
ro di bit di memoria associati ad ogni pixel) 




GRAFICA 
VETTORIALE 

La grafica vettoriale 
implica il disegno di 
primitive, quali linee, 
curve e poligoni, 
specificati da un 
insieme di punti in un 
sistema di coordinate. 
Il disegno non viene 
rappresentato dalla 
serie di pixel, che lo 
compone sullo 
schermo, ma è 
possibile, ad esempio, 
disegnare una linea 
retta specificando 
soltanto le coordinate 
dei due punti estremi, 
oppure disegnare un 
rettangolo tramite un 
punto che ne 
rappresenti la 
posizione dell'angolo 
superiore sinistro ed 
un paio di numeri che 
ne indicano la 
larghezza e l'altezza. 
Gli oggetti messi a 
disposizione da GDI+ 
per la gestione della 
grafica vettoriale sono 
racchiusi nel 
namespace 

System.Drawing.Drawi 
ng2D. 
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Fig. 4: II rettangolo ruo- 
tato. 
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GRAFICA 
RASTER 

(IMMAGINI) 

In un'immagine raster, 

lo spazio è suddiviso in 

migliaia di quadratini 

detti pixel. Ogni 

quadratino può essere 

di un colore, ed è 

compito del 

programma di grafica 

impostare il colore di 

ogni quadratino in 

base al tipo di 

strumento di disegno. 

Le immagini di questo 

tipo vengono 

memorizzate come 

bitmap, in cui ogni 

colore dei singoli punti 

sullo schermo viene 

trasformato in numero 

e memorizzato in una 

matrice. Ogni 

elemento nella 

matrice, è accessibile 

tramite una coppia di 

coordinate x-y, che 

identifica il singolo 

pixel. Gli oggetti messi 

a disposizione da GDI+ 

per la gestione delle 

immagini sono 

racchiusi nel 

namespace 

System.Drawing.lmagì 

ng. 



Vogliamo, ad esempio, creare un oggetto Bitmap 
mediante la clonazione della metà superiore di un 
oggetto Bitmap esistente, codice sarà il seguente: 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoBitmap As New Bitmap( 

"C:\MiaImmagine.jpg") 
Dim RettangoloSorgente As New Rectangle(0, 0, 

OggettoBitmap. Width, OggettoBitmap. Height / 2) 

Dim OggettoBitmapCIonato As Bitmap = 

OggettoBitmap. Clone(RettangoloSorgente, _ 
Drawing.Imaging.PixelFormat.DontCare) 
OggettoGrafico. DrawImage(OggettoBitmapClonato, 10, 10) 
OggettoBitmap. Dispose() 
OggettoBitmapCIonato. Dispose() 
OggettoGrafico. Dispose() 
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Fig. 5: Immagine esatta, ridotta, ingrandita. 



I METODI LOAD 
ESAVE 

I metodi FromFile e LoadFromStream delle classi 
Image e Bitmap consentono di caricare un'immagi- 
ne da un file o da un oggetto Stream aperto, dove 
per Stream si intende una generica sequenza di byte 
(flusso). Un flusso di byte non deve necessariamen- 
te provenire da un file ma ad esempio da una qual- 
siasi periferica di input/output, o da un socket TCP/ 
IR L'oggetto Stream permette la visualizzazione ge- 
nerica di questi diversi tipi di flusso, senza che lo svi- 
luppatore venga a contatto con i dettagli specifici 
del sistema operativo e con le periferiche sottostan- 
ti. Scriviamo una procedura che utilizza il metodo 
FromFile ed un controllo OpenFileDialogpev richie- 
dere all'utente nome dell'immagine da visualiz- 
zare ed utilizziamo il metodo Drawlmage per mo- 
strarla sullo schermo. Il codice da scrivere sarà il 
seguente 

Private Sub MostraImmagineDaFile() 

Dim OggettoGrafico As Graphics=Me.CreateGraphics 
OpenFileDialogl.Filter = "Image files|*.bmp; 

*.gif;*.jpg;*.jpeg;*.tif;*.png;" 

If OpenFileDialogl.ShowDialog=DialogResult.OK Then 

Dim OggettoBmp As Bitmap = Bitmap. FromFile( 

OpenFileDialogl.FileName) 



OggettoGrafico. DrawImage(OggettoBmp, 0, 0) 
OggettoBmp. Dispose() 
OggettoGrafico. Dispose() 

End If 

End Sub 

Il metodo Save delle classi Image e Bitmap permet- 
te di salvare un'immagine memorizzata nell'ogget- 
to corrispondente. Questo metodo accetta come 
argomenti: il nome del file ed il formato di destina- 
zione. Utilizzando un controllo SaveFileDialog pos- 
siamo scrivere una procedura che permetta di sal- 
vare un'immagine contenuta in un oggetto Bitmap, 
chiedendo all'utente di specificare il formato desi- 
derato. 

Private Sub Salvalmmagine() 

Dim OggettoGrafico As Graphics = Me.CreateGraphics 
Dim OggettoBitmap As New Bitmap("C:\MiaImmagine.jpg") 
OggettoGrafico. DrawImage(OggettoBitmap, 0, 0) 

With SaveFileDialoglQ 

.Title = "Seleziona il formato del file di 

destinazione" 

.Filter = "Bitmap|*.bmp|GIF|*.gif|JPEG|*.jpg" 

.OverwritePrompt = True 

If .ShowDialog = DialogResult.OK Then 

Select Case System. IO. Path.GetExtension( 

.FileName).Tollpper 

Case ".BMP" 

OggettoBitmap. Sa ve(.FileName, 

System. Drawing.Imaging.ImageFormat.Bmp) 
Case ".GIF" 

OggettoBitmap. Sa ve(.FileName, 

System. Drawing.Imaging.ImageFormat. Gif) 

Case "JPG" 

OggettoBitmap. Sa ve(.FileName, 

System. Drawing.Imaging.ImageFormat.Jpeg) 
Case Else 

MessageBox.Show("Formato non ammesso", 

"Attenzione", MessageBoxButtons.OK, 
MessageBoxIcon. Errar) 
End Select 

End If 

End With 

OggettoBitmap. Dispose() 
OggettoGrafico. Dispose() 
End Sub 



CONCLUSIONI 

In questo articolo abbiamo descritto le problemati- 
che relative all'utilizzo dei diversi sistemi di coordi- 
nate ammessi in GDI+, ed abbiamo analizzato la 
gestione delle immagini. Nel prossimo articolo con- 
cluderemo l'argomento GDI+ occupandoci della 
gestione del testo. 

Luigi Buono 
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Collegare uno o più metodi ad un'azione 

Delegati ed eventi 

In questo appuntamento ci occuperemo di due strumenti molto utili. 
Sia per realizzare applicazioni facilmente estensibili, sia per ottenere uno 
stile chiaro nella gestione delle azioni cui il software è interessato. 



Con questa lezione avviamo rush finale del 
corso, dedicato agli elementi più avanzati ed 
innovativi di C# e .NET. Cominceremo par- 
lando dei delegati, che consentono di richiamare dei 
metodi il cui nome e la cui posizione è nota solo a 
runtime, e non al momento della stesura del codice. 
Proseguiremo trattando gli eventi, utili per realizza- 
re applicazioni modulari capaci di gestire in modo 
chiaro e semplice ogni tipo di azione prevista dallo 
sviluppatore. 



DELEGATI 

Un delegato è un oggetto che può far riferimento ad 
un metodo. Chi ha qualche esperienza di program- 
mazione con C/C++ può immaginare i delegati di C# 
come una sorta di puntatori a funzione. Con i dele- 
gati è possibile richiamare un metodo senza cono- 
scerne a priori il nome. I delegati giocano un ruolo 
importante nello sviluppo di applicazioni che godo- 
no della possibilità di essere facilmente estese attra- 
verso l'uso di componenti che funzionino a mo' di 
plug-in. Questo concetto sarà presto più chiaro, 
dopo aver dimostrato praticamente l'utilizzo e lo 
scopo dei delegati. La sintassi di riferimento per la 
definizione di un delegato è: 

delegate tipo-restituito nome(lista-parametri); 

delegate è la parola chiave utilizzata per la definizio- 
ne di un delegato; tipo-restituito è il tipo del valore di 
ritorno dei metodi che potenzialmente potranno 
essere richiamati attraverso le istanze del delegato; 
nome è il nome che il programmatore vuole asse- 
gnare al delegato; lista-parametri è l'elenco dei 
parametri accettati dai metodi che potenzialmente 
potranno essere richiamati attraverso le istanze del 
delegato. Una volta definito il delegato che si inten- 
de sfruttare, è possibile associare alle sue istanze 
qualsiasi metodo che ne rispetti la firma, cioè che 
abbia lo stesso tipo di ritorno e la stessa lista di argo- 
menti specificati alla definizione del delegato. Ogni 
singolo delegato, quindi, può essere usato per rap- 



presentare una sola famiglia di metodi. La parola 
delegate è un po' come la parola class: con essa si 
crea un modello, non un'istanza. Istanziare un dele- 
gato, poi, è come istanziare una classe: 

NomeDelegato nomelstanzaDelegato = new 

NomeDelegato(nome-metodo); 

L'argomento fornito al "costruttore" del delegato, 
nome-metodo, è il nome del metodo che l'istanza 
del delegato sarà in grado di richiamare. Natural- 
mente il metodo specificato deve rispettare la firma 
del delegato, altrimenti niente da fare. Richiamare 
un metodo delegato è semplice e naturale: 

risultato = nomelstanzaDelegato(lista-argomenti); 

Passiamo all'analisi di un esempio pratico, che risol- 
verà parecchi dubbi: 

// Definizione del delegato. 

delegate int OperazioneAritmetica(int operandol, 

int operando2); 
class Test { 
static int addizione(int a, int b) { 

return a + b; } 
static int sottrazione(int a, int b) { 

return a - b;} 
static int moltiplicazione(int a, int b) { 

return a * b; } 
static int divisione(int a, int b) { 

return a / b; } 
public static void Main() { 

int ol = 117; 

int o2 = 13; 

int risultato; 

// Istanza del delegato. 
OperazioneAritmetica calcola = new 

OperazioneAritmetica(addizione); 
risultato = calcola(ol, o2); 
System. Console. WriteLine(" Prima operazione, 

risultato: " + risultato); 
// Nuova istanza del delegato, 
calcola = new OperazioneAritmetica(sottrazione); 
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risultato = calcola(ol, o2); 

System. Console. WriteLine("Seconda operazione, 

risultato: " + risultato); 
// Nuova istanza del delegato, 
calcola = new OperazioneAritmetica(moltiplicazione); 
risultato = calcola(ol, o2); 
System. Console. WriteLine("Terza operazione, 

risultato: " + risultato); 
// Nuova istanza del delegato, 
calcola = new OperazioneAritmetica(divisione); 

risultato = calcolaci, o2); 

System. Console. WriteLine("Quarta operazione, 

risultato: " + risultato); } 



} 



Questo esempio contiene la definizione di un dele- 
gato: 

delegate int OperazioneAritmetica(int operandol, 

int operando2); 

Con questa definizione sarà possibile istanziare dei 
delegati che "puntino" a tutti quei metodi la cui 
firma sia caratterizzata da un valore di ritorno di tipo 
int e da due parametri anch'essi di tipo int. La classe 
Test, contiene quattro metodi statici che soddisfano 
questo requisito: addizioneQ, sottrazioneO, moltipli- 
cazioneO e divisioneO- Nel MainQ della classe si 
creano quattro differenti istanze del delegato Ope- 
razioneAritmetica, ognuna delle quali viene associa- 
ta ad uno dei metodi statici appena presentati. I 
delegati ottenuti sono quindi utilizzati come degli 
alias verso i quattro metodi statici della classe. 



OMETTIAMO I 
METODI STATICI 

L'impiego di metodi statici, nell'esempio appena 
visto, non è di per sé significativo: i delegati possono 
far riferimento anche a metodi di altro tipo. 
Rivediamo l'esempio precedente, forzando una 
modifica che ci consenta di trasformare addizioneO, 
sottrazioneO, moltiplicazione e divisioneO da me- 
todi statici a comuni metodi d'istanza: 



delegate int OperazioneAritmetica(int oper; 

int 


ndol, 
operando2); 


class Aritmetica { 


public int addizione(int a 


int b) { 




return a + b; } 


public int sottrazione(int 


a, int b) { 




return a - b;} 


public int moltiplicazione 


int a, int b) { 




return a * b;} 


public int divisione(int a. 


int b) { 




return a / b;} } 


class Test { 



public static void Main() { 
Aritmetica a = new Aritmetica(); 

int ol = 117; 

int o2 = 13; 

int risultato; 

OperazioneAritmetica calcola = new 

OperazioneAritmetica(a. addizione); 
risultato = calcola(ol, o2); 
System. Console. WriteLine(" Prima operazione, 

risultato: " + risultato); 
calcola = new OperazioneAritmetica(a. sottrazione); 
risultato = calcola(ol, o2); 
System. Console. WriteLine("Seconda operazione, 

risultato: " + risultato); 
calcola = new OperazioneAritmetica(a. moltiplicazione); 
risultato = calcola(ol, o2); 
System. Console. WriteLine("Terza operazione, 

risultato: " + risultato); 
calcola = new OperazioneAritmetica(a. divisione); 
risultato = calcola(ol, o2); 
System. Console. WriteLine("Quarta operazione, 

risultato: " + risultato); } 



} 



I quattro metodi sono stati raccolti all'interno della 
classe Aritmetica, che è necessario istanziare per 
avere accesso alle sue funzionalità. 



MULTICASTiniG 
DEI DELEGATI 

Si chiama muticasting un'interessantissima pro- 
prietà dei delegati, che permette di concatenare 
l'uso di più metodi in una sola istanza di un delega- 
to. In pratica, è possibile, con una sola chiamata ad 
un delegato, eseguire n metodi con la stessa firma, 
sullo stesso gruppo di argomenti. Farlo è molto sem- 
plice: basta "sommare" tra di loro più istanze di uno 
stesso delegato, con l'operatore + (o con +=). Uno 
specifico metodo, poi, può essere eliminato dalla 
catena usando l'operatore - (o -=). C'è una sola 
restrizione: possono partecipare ad un multicasting 
solo quei metodi il cui tipo di ritorno sia void. 
Analizziamo il seguente esempio: 
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static void divisione(int a, int b) { 

int ris = a / b; 

System. Console. WriteLine(a + " / " + b + " = " + ris); } 
public static void Main() { 

OperazioneAritmetica calcola = new 

OperazioneAritmetica(addizione); 

calcola += new OperazioneAritmetica(sottrazione); 

calcola += new OperazioneAritmetica(moltiplicazione); 

calcola += new OperazioneAritmetica(divisione); 

calcola(10, 5);} 



Siamo di fronte ad una variante del primo esempio 
dimostrato nel paragrafo precedente. Anzitutto, 
nella definizione del delegato, il tipo di ritorno è 
stato cambiato da int a void. Poi sono stati modifica- 
ti i quattro metodi statici addizione!], sottrazioneO, 
moltiplicazione e dlvlsloneQ. Ora, il risultato calco- 
lato da questi quattro metodi non è più restituito al 
codice chiamante (il tipo di ritorno è diventato 
void), ma vengono direttamente stampati sullo 
schermo. Nel MainQ dell'applicazione sono stati 
istanziati quattro delegati di tipo OperazioneArit- 
metica, uno per ogni metodo statico previsto, ed in- 
sieme sono stati concatenati all'interno del riferi- 
mento calcola. Richiamando il delegato calcolaQ su 
due operandi qualsiasi si ottiene la chiamata ordina- 
ta dei quattro metodi statici elaborati in precedenza. 
L'output mostrato è: 

10 + 5 = 15 
10-5 = 5 
10*5 = 50 
10/5 = 2 

Con il multicasting dei delegati si soffre della limita- 
zione di non poter usare altro tipo di ritorno all'in- 
fuori di void. Come fare, allora, se si desidera calco- 
lare un risultato che, in qualche modo, possa poi 
essere successivamente manipolato dal program- 
matore? E' sufficiente introdurre nella definizione 
del delegato (e dei metodi che dovranno essere rife- 
riti) almeno un parametro sul quale si faccia effetto 
collaterale, come si dice in gergo, cioè cui conte- 
nuto venga modificato dai singoli metodi richiama- 
ti. Lo si può fare con un oggetto, oppure passando 
per riferimento (parola chiave refi uno dei tipi che 
solitamente viene passato per valore. Ecco un esem- 
pio: 



delegate vo 


d OperazioneAritmetica(int operandol, 

int operando2, ref int risultato); 


class Test { 


static void 


addizìone(int a, int b 


ref int ris) { 


ris += a 


+ b;} 




static void 


sottrazione(int a, int b, ref int ris) { 


ris += a 


-b; } 




static void 


moltiplicazione(int a, 


int b, ref int ris) { 



ris += a * b; } 
static void divisione(int a, int b, ref int ris) { 

ris += a / b; } 

public static void Main() { 

OperazioneAritmetica calcola = 

new OperazioneAritmetica(addizione); 

calcola += new OperazioneAritmetica(sottrazione); 

calcola += new OperazioneAritmetica(moltiplicazione); 

calcola += new OperazioneAritmetica(divisione); 

int ris = 0; 

calcola(10, 5, ref ris); 

System. Console. WriteLine(ris);} 




} 



Con la nuova modifica apportata, lo scopo di ogni 
singolo metodo diventa eseguire il proprio calcolo 
per poi sommarlo al valore già contenuto nella 
variabile ris passata per riferimento. In questa 
maniera è stato svolto il calcolo: 

(10 + 5) + (10-5) + (10 *5) + (1015) 



INTRODUZIONE 
AGLI EVENTI 

Gli eventi ricoprono un importante ruolo nei più 
moderni stili di programmazione. Cerchiamo anzi- 
tutto di inquadrare cosa sia un evento. Un evento è 
la notifica dell'accadimento di un'azione. Suppo- 
niamo di essere interessati a sapere quando e come 
una certa cosa accadrà. Con il nostro codice possia- 
mo registrare un gestore di eventi verso l'azione che 
ci interessa. Ad ogni singola azione possono essere 
associati più gestori. Quando l'azione attesa è ese- 
guita, tutti i gestori di eventi ad essa collegati vengo- 
no attivati, propagando l'evento. Un esempio prati- 
co ce lo forniscono le interfacce grafiche: un evento 
esemplificativo è la pressione di un bottone presen- 
te nella finestra dell'applicazione. Il programmatore, 
in condizioni normali, è interessato a sapere quando 
l'utente clicca su uno dei bottoni mostrati. Per que- 
sto registra un gestore di eventi idoneo. Il risultato è 
che, alla pressione del bottone, uno o più metodi 
vengono automaticamente richiamati. Dentro que- 
sti metodi, naturalmente, va inserito il codice che 
deve fornire una risposta al comando dell'utente. Ad 
esempio, se programma è una videoscrittura e sul 
bottone da premere c'è scritto "Salva", è probabile 
che i metodi ad esso collegati mediante i gestori di 
eventi dovranno eseguire i passi necessari per salva- 
re il documento corrente e soddisfare, così, la richie- 
sta dell'utente. Gli eventi, in C#, sono una particola- 
re forma di delegati. Gli eventi appaiono come 
membri di una classe, al pari delle proprietà e dei 
metodi. La sintassi è: 

event nome-delegato nome-evento; 




CORSI BASE T 



I 



C# 





CONTATTA 
/ L'AUTORE 



Se desideri contattare 

l'autore di questo 

articolo scrivi a 

cario. pelliccia® 
ioproqrammo.it 



La clausola nome-delegato specifica il tipo di dele- 
gato associato all'evento, che deve essere stato defi- 
nito in precedenza esternamente alla classe; nome- 
evento, invece, è semplicemente il nome che il pro- 
grammatore sceglie di dare all'elemento. Passiamo 
ad un esempio concreto: 

delegate void NotificaRisultato(int quanteSomme, 

int risultato); 
class Somma { 
public event NotificaRisultato ogniCìnqueSomme; 
private int totale = 0; 
private int sommeEffettuate = 0; 
public void aggiungi(int n) { 
totale += n; 
sommeEffettuate+ + ; 

if (sommeEffettuate % 5 == 0) { 

ogniCinqueSomme(sommeEffettuate, totale);}} 

} 

class Test { 
static void stampaRisultato(int quanteSomme, 

int risultato) { 
System. Console. WriteLine("Sono stati introdotti " 

+ quanteSomme + " numeri"); 
System. Console. WriteLine("Somma ottenuta: " 

+ risultato); } 
public static void Main() { 
Somma s = new SommaQ; 
s.ogniCinqueSomme += new 

NotificaRisultato(stampa Risultato); 
while (true) { 
System. Console. Write("Inserisci un numero intero: "); 
int n = System. Int32.Parse( 

System. Console. ReadLineQ); 

s.aggiungi(n);}} 
} 



CRONACA 

DI UHI EVENTO 

Cominciamo l'analisi osservando la classe Somma. 
Scopo di questo elemento è fornire oggetti che pos- 
sano memorizzare una somma. Si comincia da zero, 
ovviamente, ed il metodo aggiungi!] può essere 
sfruttato per incrementare il totale rappresentato 
dall'oggetto. 
La classe definisce un evento: 

public event NotificaRisultato ogniCinqueSomme; 

Il delegato associato a questo evento è: 

delegate void NotificaRisultato(int quanteSomme, 

int risultato); 

Andiamo ad esaminare il metodo aggiungici. 

Il codice ricorda, attraverso l'intero sommeEffettua- 



te, quante volte il metodo sia stato richiamato. Ogni 
cinque somme vengono attivati i gestori di evento 
associati a ogniCinqueSomme: 

if (sommeEffettuate % 5 == 0) 

{ 

ogniCinqueSomme(sommeEffettuate, totale); 

} 

La propagazione di un evento, come è possibile 
osservare, si esegue richiamando il nome dell'even- 
to come se questo fosse un metodo, fornendo inol- 
tre gli eventuali argomenti richiesti. 

Andiamo ora a vedere il codice della classe Test. 
Questa contiene un metodo, stampaRisultatoO, 
conforme al delegato NotificaRisultato, e quindi 
adatto anche all'evento ogniCinqueSomme di 
Somma. NelMainQ, dopo aver realizzato un'istanza 
di Somma, il metodo stampaRisultatoO viene regi- 
strato come gestore dell'evento ogniCinqueSomme. 
Tutto è molto semplice, giacché si ragiona come per 
i delegati: 

Somma s = new Somma(); 
s.ogniCinqueSomme += new 

NotificaRisultato(stampaRisultato); 

Eseguendo il programma, verrà continuamente 
richiesto all'utente l'inserimento di un valore intero 




Fig. 1: II nostro piccolo esempio alle prese con la 
sbrie di fibonacci. 



{CTRL + C per interrompere il programma). Ogni 
cinque valori inseriti, il metodo aggiungici di Som- 
ma attiverà l'evento, come spiegato prima. Di con- 
seguenza saranno richiamati tutti i gestori ad esso 
collegati, nel nostro caso il solo stampaRisultatoO- 
Sulla console apparirà in output un messaggio che 
informerà l'utente sul numero di somme effettuate 
e sul risultato ottenuto. Più gestori possono essere 
registrati verso un solo evento, sfruttando gli opera- 
tori + e += come per i delegati; e sempre come per i 
delegati, un gestore può essere rimosso dalla catena 
con - o con -=. 

Carlo Pelliccia 
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Chiudiamo il corso e l'intero ciclo sull'ottimizzazione 

Ottimizzazione 



del codice 



(parte terza) 



In questa ultima puntata analizzeremo i concetti per migliorare 
le performance del codice. In particolare, focalizzeremo l'attenzione 
sui valori di ritorno delle funzioni. 



Nel corso delle ultime due puntate ab- 
biamo visto dapprima le ottimizza- 
zioni preventive (quelle che possono 
precedere la scrittura del codice), quindi le 
ottimizzazioni inerenti la codifica (tutti gli 
accorgimenti che consentono di migliorare 
le prestazioni del software, e che possono es- 
sere seguiti durante la vera e propria scrittu- 
ra del codice). Abbiamo dato delle linee gui- 
da che ricordiamo nuovamente: 

• la velocità di un programma che non fun- 
ziona è irrilevante; 

• la fase di ottimizzazione deve essere po- 
sticipata il più possibile; 

• il miglior compilatore è tra le nostre orec- 
chie; 

• si ottimizzano i programmi troppo in- 
gombranti o troppo lenti; 

• la rapidità di esecuzione non è legata alla 
lunghezza del codice. 

È tenendo sempre presente queste osserva- 
zioni che andiamo a guardare in questo ap- 
puntamento quelle che sono le ottimizzazio- 
ni finali del codice. 



OTTIMIZZAZIONE DEI 
VALORI DI RITORNO 

Quando scriviamo le nostre funzioni, dob- 
biamo sempre tenere a mente che il C++ crea 
e distrugge oggetti in punti del codice che 
non sono affatto ovvi. 



Ad esempio, parlando di liste di inizializza- 
zione, nella scorsa puntata abbiamo visto 
che quando viene chiamato un costruttore 
che non prevede tali liste, le variabili che rap- 
presentano le proprietà dell'oggetto creato 
vengono comunque istanziate, in maniera 
implicita, prima dell'istruzione iniziale del 
corpo del costruttore. 

Un qualcosa di analogo succede quando in 
una funzione restituiamo un risultato di un 
qualsiasi tipo, sia esso un intero o di un tipo 
da noi definito. 
Esaminiamo un semplice esempio: 

complex<double> CreaCpx(double Re, doublé Im) { 

complex<double> num_comp(Re,Im); 

return num_comp; 
} 

In questo esempio abbiamo fatto uso di uno 
dei tipi definiti nella STL, il tipo complex; es- 
so si usa per rappresentare i numeri com- 
plessi, ed è definito mediante template per 
poter così usare i numeri complessi basati su 
più tipi possibili. 

Nella STL sono anche presenti, per inciso, 
delle specializzazioni di questo tipo generico 
relativamente ai numeri complessi basati su 
tipi float, doublé e long doublé. In questa fun- 
zione così semplice, che si limita a costruire 
un numero complesso dati due numeri di ti- 
po doublé, sono presenti in realtà moltissime 
inefficienze: ci possiamo infatti chiedere pri- 
ma di tutto se sia proprio necessaria questa 
funzione, visto che a tutti gli effetti è un 
wrapper del costruttore dei numeri comples- 
si, cioè una funzione contenitore il cui scopo 
è permettere di chiamare il costruttore dei 
numeri complessi in un altro modo, e le con- 
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siderazioni che ne scaturiscono fanno parte 
della fase di ottimizzazione preventiva. 
A questo si può aggiungere una considera- 
zione non banale: come già accennato esi- 
stono delle specializzazioni del tipo complex 
già pronte, reperibili nella STL, e una di que- 
ste è proprio l'implementazione del tipo 
complex basata sui doublé; quindi, perché 
non usare direttamente quella invece del 
tipo complex<double>? 
Con ogni probabilità non saremmo in grado 
di scrivere un codice migliore e più prestan- 
te di quello che ci fornisce gratuitamente la 
STL. Anche questa è una considerazione che 
ha a che fare con l'ottimizzazione preven- 
tiva. Se poi guardiamo la lista dei parametri 
passati alla funzione ci accorgiamo che essi 
sono passati per valore: questo significa che 
si dovranno avere delle variabili temporanee 
per la copia dei parametri e, facendo le con- 
siderazioni già svolte parlando del passaggio 
dei parametri, giungeremmo alla considera- 
zione che molto più prestante sarebbe stato 
passare tali parametri come riferimento co- 
stante. 



APPROFONDIMENTI 



A chi volesse approfondire la conoscenza delle librerie standard C++, 
consigliamo il validissimo libro "Thinkìng in C++ - 2nd ed. - Volume 2" di 
Bruce Eckel e Chuck Allison, che rappresenta sicuramente un ottimo 
riferimento per i programmatori più avanzati (o aspiranti tali) ed è 
oltretutto disponibile gratuitamente per il download, partendo 
dall'indirizzo http://www.mindview.net/Books/TICPP/ThinkinqlnCPP2e.html 

Se volete invece dare un'occhiata a una reference delle funzioni standard 
del C per la manipolazione di stringhe (o meglio: di array di caratteri 
terminati da "\0" :-) consultate l'indirizzo: 

http://www.cplusplus.com/ref/cstrinq/ 

Online è inoltre disponibile l'utilissimo "C++ Annotations" all'URL: 
http://www.icce.rug.nl/documents/ che merita di essere visto (e letto) almeno 
una volta. 



Facciamo finta però che tutte queste consi- 
derazioni non abbiano senso, e che la fun- 
zione sia concepibile solo in questa forma: 
anche in questo caso mancherebbe ancora 
una possibile ottimizzazione, quella del 
valore di ritorno. 

La nostra funzione, infatti, all'atto della 
restituzione del valore dovrà creare un og- 
getto temporaneo di tipo complex<double> 
per contenere il risultato (una copia dell'og- 
getto num_comp creato al suo interno); in 
altre parole, la nostra funzione crea un 
oggetto temporaneo al suo interno, la va- 
riabile num_comp, usando come valori i 



parametri che riceve in ingresso, in effetti 
non restituisce tale oggetto ma solo il suo 
valore! Questo comporta che numjzomp an- 
drà distrutta al termine dell'esecuzione della 
funzione (e qui verrà quindi chiamato l'op- 
portuno distruttore), ma soprattutto che il 
valore di numjzomp dovrà essere copiato in 
un oggetto temporaneo che contiene il ri- 
sultato della funzione (con conseguente 
spreco di spazio e di tempo, per via della 
chiamata al costruttore di copia). Tutte que- 
ste inefficienze potevano essere evitate me- 
diante un semplice accorgimento, che pos- 
siamo osservare nella versione riveduta del- 
la funzione: 

complex<double> CreaCpx(double Re, Doublé Im) 

{ 

return (complex<double>(Re,Im)); 

} 

Interpretando alla lettera il corpo della fun- 
zione cogliamo subito una sottile, ma fonda- 
mentale, differenza: non restituiamo sem- 
plicemente un risultato, ma un vero e pro- 
prio oggetto senza nome. Questo accorgi- 
mento permette al compilatore di compiere 
una piccola magia: invece di copiare il risul- 
tato della funzione nella variabile /oggetto di 
destinazione, esso può costruire tale ogget- 
to-risultato direttamente nello spazio di me- 
moria dell'oggetto che conterrà tale risultato 
al di fuori della funzione, evitando così di 
effettuare copie e di chiamare, quindi, co- 
struttori di copia. La magia è possibile per- 
ché il compilatore "capisce" che non avrà a 
che fare con valori temporanei, e potrà lavo- 
rare con gli oggetti del programma da cui la 
funzione è stata chiamata. 
Se avessimo usato una variabile tempora- 
nea, il compilatore sarebbe stato costretto a 
rispettare il nostro volere, e avrebbe perciò 
dovuto costruire tale variabile, copiarla in 
un oggetto temporaneo contenente il risul- 
tato della funzione, e quindi distruggere tale 
variabile temporanea al termine dell'esecu- 
zione della funzione. 

Notiamo infine un dettaglio che però mette 
in risalto l'importanza della questione. 
Le definizioni più recenti del C++ standard 
sono strutturate in modo che per un compi- 
latore, sotto opportune ipotesi, sia possibile 
evitare questi oggetti temporanei contenen- 
ti i risultati delle funzioni. Questo comporta 
il fatto che, forse, tra qualche anno i compi- 
latori ottimizzeranno in automatico i valori 
di ritorno delle funzioni, senza costringerci a 
ottimizzare "manualmente" il codice. 
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VALORI DI RITORNO 
E PARAMETRI 
PER RIFERIMENTO 

Alla luce di quanto visto nel paragrafo prece- 
dente, sarebbe una agognata possibilità 
quella di poter fare una cosa di questo tipo: 

complex<double>& CreaCpx(double Re,double Im) 

{ 

complex<double> num_comp(Re,Im); 

return num_comp; 
} 

In pratica restituire come risultato della fun- 
zione non una copia dell'oggetto ma l'ogget- 
to stesso (tramite un riferimento ad esso), 
ferma restando la possibilità di costruire tale 
oggetto nel corpo funzione, con tutta la fles- 
sibilità semantica che questo consentirebbe. 
Questa semplice modifica comporterebbe il 
non dover fare null'altro per ottimizzare il 
nostro codice (sempre nelle ipotesi prece- 
dentemente poste che il meccanismo con cui 
opera la funzione e la lista di parametri siano 
necessariamente da lasciare immutati). Una 
sola pressione di tasti e avremmo fatto tutto 
quanto nelle nostre facoltà per ottenere il 
massimo. Magari fosse così semplice! In 
realtà l'aggiunta di quella "&" al tipo restitui- 
to è una cosa pericolosissima, in quanto non 
solo non è un errore a livello sintattico (nel 
senso che un compilatore potrebbe non rile- 
vare alcuna anomalia in quanto scritto), ma 
potrebbe non essere considerato un errore 
neanche a livello semantico. Come abbiamo 
detto, l'oggetto num_comp verrà distrutto al 
termine della funzione, quindi un riferimen- 
to a num_comp punterà in realtà non al risul- 
tato ma a un'area di memoria dominata 
potenzialmente dal caos (non ci è dato sape- 
re cosa succederà nell'area di memoria occu- 
pata da num_comp dopo che tale area verrà 
deallocata e quindi, potenzialmente, riutiliz- 
zata). Però questo per il compilatore non è 
un errore, e, nel migliore dei casi, probabil- 
mente avremo al massimo un warning, cioè 
un avviso di una possibile fonte di errore (in 
questo caso, a run-time). Appurato che una 
soluzione come questa non è percorribile, 
diciamo anche che ne esiste un surrogato. Lo 
stratagemma consiste nel passare alla fun- 
zione un parametro che è in realtà il conteni- 
tore del risultato. Ad esempio nel nostro caso 
potremmo fare così: 

void CreaCpx(double Re, doublé Im, 

complex<double>& res) 



complex<double> num_comp(Re,Im); 
res = num_comp; 



} 



Si notino due cose: il tipo ritornato non è più 
complex<double> ma void (in realtà, potrem- 
mo far comunque ritornare qualcosa, ad 
esempio un bool che segnali la corretta ese- 
cuzione delle operazioni della funzione, ma 
comunque il risultato vero e proprio sarà 
contenuto in uno dei parametri), e il risulta- 
to sarà una delle variabili passate (per riferi- 
mento) come parametro. A questo proposito 
vogliamo inoltre far notare l'importanza del- 
l'utilizzo della particella "const" quando si ef- 
fettua il passaggio di un parametro che re- 
sterà immutato, per riferimento anziché per 
valore, per evitarne la copia. La const è quin- 
di utilizzata, oltre che per evidenti motivi se- 
mantici, anche per distinguere quest'ultimo 
caso dal caso precedente di restituzione di 
un risultato tramite parametro passato per 
riferimento. 



uni UTILIZZO 
ATTENTO DELLE 
FUNZIONI VIRTUALI 

Sebbene siano uno dei grossi vantaggi dell'u- 
tilizzo di linguaggi potenti come il C++, le 
funzioni virtuali (cioè le funzioni contraddi- 
stinte dalla clausola virtual, per le quali l'in- 
vocazione è decisa a run-time) costituiscono 
un argomento "scottante" nel campo delle 
ottimizzazioni del codice. L'utilizzo di que- 
sto tipo di funzione infatti, comporta un 
overhead di prestazioni dovuto alla necessità 
di utilizzare un livello aggiuntivo di indire- 
zione. 

Una singola funzione virtuale in una classe 
richiede che ogni oggetto della classe, e ogni 
oggetto derivato, contengano un puntatore 
aggiuntivo; questo può avere un effetto 
negativo sulle dimensioni di oggetti piccoli 
che possono arrivare anche a raddoppiare. 
Ad esempio la seguente classe 
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genera degli oggetti di dimensione 8 byte 
(cioè sizeof(OggettoVirtuale) == 8). Una pos- 
sibile conversione di questa classe in una 
struttura che non faccia uso di funzioni vir- 
tuali è la seguente: 



NON TUTTI I WRAPPER VENGONO PER NUOCERE 



Sebbene il piccolo wrapper inserito, a scopo didattico, in questa lezione 
sia sostanzialmente inutile, nei casi reali a volte capita di dover 
progettare dei moduli che consentano di raggruppare varie funzionalità 
di una classe, senza per questo dovere riscrivere l'intero codice che la 
compone. In casi in cui si abbia un programma molto grande e si debba 
modificare il comportamento di una classe, invece di sostituire tale classe 
in toto (e quindi andare a rintracciare tutti i tratti di codice in cui essa 
compare per sostituirli uno ad uno, cosa che per software estesi è 
improponibile) potremmo semplicemente creare un wrapper, cioè una 
classe "fantoccio" che fornisca all'esterno la nuova interfaccia ma che 
utilizzi al suo interno il codice preesistente, che in questo modo non 
andrà "buttato via". 



gibile dell'utilizzo delle clausole virtual, sen- 
za che ciò porti a un effettivo vantaggio in 
termini di prestazioni, in quanto la gestione 
"nativa" delle VFT è di gran lunga più perfor- 
mante. Alcuni compilatori consentono di 
impostare dei parametri relativi all'inizializ- 
zazione delle VFT in modo da rendere il codi- 
ce più veloce. È il caso ad esempio della di- 
rettiva 

declspec(novtable) 

che consente di disabilitare la creazione 
della VFT nel costruttore di un oggetto. 
Questo normalmente produce un effetto de- 
leterio, tranne nel caso di classi base astratte, 
per le quali non c'è nessuna necessità di ini- 
zializzare i puntatori della VFT, in quanto 
questi saranno certamente creati nella fase 
di istanziazione degli oggetti delle classi de- 
rivate (ricordiamo che non è possibile creare 
oggetti di classi contenenti funzioni virtuali 
pure). La direttiva appena citata è però spe- 
cifica per i compilatori Microsoft (non fa 
quindi parte dello standard del C++). Un uti- 
lizzo di tale caratteristica implica, quindi, 
una ricerca da parte del programmatore del- 
la funzionalità corrispondente (se presente) 
all'interno delle opzioni messe a disposizio- 
ne dallo specifico compilatore utilizzato. 
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La dimensione degli oggetti relativi è di 4 by- 
te, esattamente la metà, per una classe che 
praticamente ha le stesse funzionalità. Oltre 
alle dimensioni maggiori, l'utilizzo di funzio- 
ni virtuali causa un appesantimento a tempo 
di esecuzione, in quanto bisogna inizializza- 
re una VFT (virtual function table, cioè la 
struttura dati che si occupa della gestione 
delle funzioni virtuali) per ogni oggetto che 
si crea. Inoltre anche la chiamata stessa di 
una funzione virtuale è più lenta rispetto alla 
chiamata di una funzione non virtuale. Alla 
luce di quanto esposto è consigliabile non 
utilizzare (tenendo sempre a mente, le rego- 
le guida per una buona metodologia di otti- 
mizzazione) le funzioni virtuali laddove que- 
ste non siano strettamente necessarie. C'è 
però da dire che, qualora si abbia davvero bi- 
sogno di utilizzare un meccanismo di questo 
tipo, difficilmente si riuscirà a svilupparne 
uno più efficiente di quello messo a di- 
sposizione dal C++. Si dovrebbe infatti inse- 
rire in ogni classe una variabile (flag) che ne 
indichi il tipo per il riconoscimento a run- 
time e, probabilmente, uno switch che con- 
trolli il valore di tale flag. Questo meccani- 
smo è molto più soggetto a errori e meno leg- 



CONCLUSIONI 

Abbiamo terminato, con questa puntata, 
l'argomento delle ottimizzazioni del codice 
C++, nonché il ciclo di lezioni relative a que- 
sto corso. Abbiamo cercato, nel corso di que- 
ste 25 puntate, di coprire il più vasto numero 
di argomenti del linguaggio, partendo dalle 
basi sino ad arrivare ad argomenti abbastan- 
za complessi e delicati come ad esempio 
quello delle ultime lezioni. Il nostro scopo è 
sempre stato quello di inserire concetti teori- 
ci fondamentali all'interno di implementa- 
zioni pratiche in modo da rendere subito 
comprensibile il concetto che si stava espo- 
nendo. Speriamo di essere riusciti nel nostro 
intento di realizzare un corso completo, 
esauriente e "user friendly" e desideriamo 
ringraziare tutti i lettori che ci hanno seguito 
in questo viaggio, e in particolar modo quelli 
che (numerosi) ci hanno contattato tramite 
posta elettronica per esprimere opinioni, 
dubbi e suggerimenti. 
Un grazie di cuore e... a presto! 

Alfredo Marroccelli 
Marco Del Gobbo 
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Impara ad usare il polimorfismo con Java 

La classe che 
cambiò forma 

Come per magia, può un oggetto assumere diverse forme? 
Eccome, se può! Il polimorfismo è una delle caratteristiche più 
importanti di Java e degli altri linguaggi orientati agli oggetti. 



Il mese scorso hai imparato cos'è l'ereditarietà. 
Questo mese continueremo il discorso per par- 
lare di quella che è forse la caratteristica più im- 
portante della programmazione orientata agli og- 
getti: il polimorfismo. Questa lezione può sembrare 
semplice, perché non incontrerai nessuna nuova 
parola chiave. Ma i concetti nei quali stai per imbat- 
terti hanno ramificazioni profonde. Non prendere 
sottogamba il polimorfismo: esistono programma- 
tori esperti che non hanno mai imparato ad usarlo 
come si deve. Se riuscirai a capirlo e a sfruttarlo a 
fondo, ti assicuro che non guarderai indietro. 



Puoi creare una Persona e imbastire una semplice 
conversazione: 

Persona passante = new Persona(); 

passante. saluta(); 

passante. daiIndicazioniPer("Piazza della Vittoria"); 

La Persona risponde alla conversazione stampando 
sullo schermo: 



Salve! 

Per andare in Piazza della Vittoria si deve girare in 

fondo a destra. 
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OBIETTIVI 

1) Imparerai cos'è l'upcasting. 

2) Scriverai le tue prime operazioni polimorfiche. 

3) Vedrai come si può usare il polimorfismo per 
costruire programmi estensibili. 

Bando agli indugi e... 

...COMINCIAMO! 

Guarda questa classe: 

class Persona { 
public void saluta() { 

System. out.println("Salve!"); } 
public void daiIndicazioniPer(String destinazione) { 
System. out.println("Per andare in " + destinazione 
+ " si deve girare in fondo a destra."); } 
public void ricevilnsultoQ { 

System. out.println("Ma come ti permetti?"); } 
public void medita() { 
System. out.println("mumble, mumble..."); } 
} 



Ecco ora una classe che eredita da Persona e ridefi- 
nisce alcuni metodi (cioè ne fa l'override): 

class Vecchietto extends Persona { 
public void saluta() { 

System. out.println("I miei rispetti alla Sua signora."); } 
public void riceviInsulto() { 

System. out.println("Lei non sa chi sono io!"); } 
public void passeggiaQ { 
System. out.println("Tu-de-dum..."); } 
} 

Se guardi la rappresentazione in UML di queste due 
classi vedrai che il Vecchietto riceve in ereditarietà 
tutti i metodi della Persona, ma ne ridefinisce due a 
modo proprio e ne aggiunge uno nuovo di zecca. 
Quindi Vecchietto eredita solo in parte il codice di 
Persona, ma ne eredita completamente le caratteri- 
stiche - per essere più precisi, la sua interfaccia. 
L'interfaccia di una classe è l'insieme dei suoi meto- 
di e dei suoi campi non privati. I metodi salutaQ e 
dailndicazioniPerO sono nell'interfaccia di Persona, 
quindi tutte le classi che ereditano da Persona devo- 
no avere questi metodi. Una sottoclasse non può 
"eliminare" i metodi della sua superclasse. 
Di solito si dice che una classe è legata alla sua su- 
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DINAMICO 

Il polimorfismo si basa 

su un meccanismo che 

si chiama binding 

dinamico. In un 

linguaggio tradizionale 

come il C, tutte le 

chiamate a funzione 

vengono risolte 

durante la 

compilazione. Questo 

significa che il 

programma contiene 

sono "salti" diretti da 

una parte all'altra del 

codice. Nei linguaggi 

orientati agli oggetti, 

invece, le chiamate a 

metodo sono risolte 

solo mentre il 

programma sta 

girando. Per questo 

motivo un programma 

può chiamare metodi 

diversi a seconda 

dell'oggetto che gli 

viene passato. 
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Fig. 1: UML: la relazione "is__a" tra vecchietto e persona. 

perclasse da una relazione "is_a" (per dirla in italia- 
no, da una relazione "è un"). Un Vecchietto "è una" 
Persona, cioè qualsiasi oggetto di tipo Vecchietto è 
anche un oggetto di tipo Persona. Quindi puoi scri- 
vere una riga come questa: 

Persona p = new Vecchietto(); 

Come forse ricordi, l'operazione di new restituisce 
un reference all'oggetto appena creato. Di solito, per 
evitare che questo reference e il relativo oggetto va- 
dano persi, devi assegnare il reference ad una varia- 
bile. È quello che ho fatto anche in questo caso, con 
una importante differenza: la variabile non ha esat- 
tamente lo stesso tipo dell'oggetto che ho appena 
creato. L'oggetto è un Vecchietto, mentre la variabile 
p è fatta per contenere un reference di tipo Persona. 
Allora, come mai il compilatore Java accetta questo 
codice? Perché ogni Vecchietto è anche una Persona 
e quindi posso trattarlo come tale. 
Per essere precisi, l'oggetto non viene convertito. 
Quello che cambia è solo il reference. Il nostro 
oggetto è ancora un Vecchietto, ma il codice ha deci- 
so di "dimenticarsi" di avere a che fare con un Vec- 
chietto e di trattarlo come una più generica Persona. 
Ora puoi chiamare tutti i metodi di Persona sulla 
variabile p, ma non puoi più chiamare i metodi di 
Vecchietto. Nei casi come questo, nei quali assegni 
un oggetto di una sottoclasse ad un reference ad una 
superclasse, si dice che fai un upcasting, cioè una 
"conversione di tipo verso l'alto". L'upcasting deve il 
suo nome al fatto che si tratta di un "cast" (una con- 
versione di tipo) e che nei diagrammi si disegnano di 
solito le superclassi in alto e le sottoclassi in basso. 
Ora sai cos'è l'upcasting, ma non sai ancora a cosa 
serve. Per quale bizzarro motivo dovremmo "dimen- 
ticarci" il tipo di un oggetto? Perché in questo modo 
possiamo scrivere del codice che conversa con le 
persone, e questo codice potrà automaticamente 
conversare anche con i vecchietti. 

private void conversa(Persona p) { 
p.saluta(); 
p.daiIndicazioniPer("Vicolo Stretto"); } 

Questo metodo prende una Persona e si intrattiene 



in una brevissima conversazione. Cosa succede se 
passiamo un Vecchietto a conversai] 7 . Succede la 
stessa cosa che succede nella riga di codice che hai 
visto poco fa: l'oggetto Vecchietto viene "convertito 
verso l'alto" al tipo Persona. Prima l'upcasting avve- 
niva durante l'assegnamento, ora avviene durante 
passaggio del parametro. Il metodo conversaQ non è 
obbligato a distinguere tra Vecchietti e Persone. In 
effetti il metodo non sa nemmeno che esista un tipo 
Vecchietto: conosce solo le Persone. Dato che la clas- 
se Persona definisce un metodo salutaQ e un meto- 
do dailndicazioniPerQ, il metodo conversai] può 
chiamare questi metodi. Se conversa] cercasse di 
chiamare un metodo specifico del Vecchietto, come 
passeggia], il compilatore di Java si arrabberebbe - 
e farebbe bene, visto che metodo potrebbe riceve- 
re una Persona che non è un Vecchietto, e quindi non 
può passeggiare. Ho blaterato abbastanza - è ora di 
passare agli esperimenti concreti. Cosa succede se 
passi un Vecchietto al metodo conversaQ 7 . 



UHI TRUCCO MENTALE 
DI STILE JEDI 

class Conversazioni { 
private static final String DESTINAZIONE = "Via Larga"; 

public static void main(String[] args) { 

System. out.println("-— Conversazione 1: Persona"); 

Persona gino = new PersonaQ; 

conversa(gino); 

System. out.println("— Conversazione 2: Vecchietto"); 

Vecchietto piero = new Vecchietto(); 

conversa(piero); } 
private static void conversa(Persona p) { 

System. out.println("> Buongiorno!"); 

p.saluta(); 

System. out.println("> Sto cercando " + 
DESTINAZIONE + "..."); 

p.daiIndicazioniPer(DESTINAZIONE); 

System. out.println("> Ma vai a quel paese!"); 

p.riceviInsulto(); } } 

Ho reso static il metodo conversaQ, perché altrimen- 
ti non lo avrei potuto chiamare direttamente dal 
mainO. L'ho anche reso private, perché non viene 
mai chiamato dall'esterno della classe ed è sempre 
buona regola rendere le cose quanto meno visibili 
possibile. Infine ho definito una costante DESTINA- 
ZIONE per evitare di scrivere la stessa stringa più 
volte (è sempre meglio usare le costanti in questi ca- 
si - sono più esplicite, e se fai un errore di battitura 
mentre usi la costante il compilatore se ne accorge 
subito). A questo punto ti potrebbe sorgere un dub- 
bio. Esistono due versioni dei metodi salutaQ e rice- 
vilnsultoQ. Ma allora, quali versioni dei due metodi 
vengono eseguite quando conversi con il Vecchietto? 
Come dicono gli inglesi, "la prova del budino è nel 
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mangiarlo" - quindi fai girare il codice e guarda cosa 
salta fuori. 



— Conversazione 1: Persona 

> Buongiorno! 
Salve! 

> Sto cercando Vìa Larga... 

Per andare in Via Larga si deve girare in fondo a destra. 

> Ma vai a quel paese! 
Ma come ti permetti? 

— - Conversazione 2: Vecchietto 

> Buongiorno! 

I miei rispetti alla Sua signora. 

> Sto cercando Via Larga... 

Per andare in Via Larga si deve girare in fondo a destra. 

> Ma vai a quel paese! 



Questo risultato potrebbe stupirti molto... o forse 
per niente. Se sei già un programmatore ma non hai 
esperienza di object-oriented, sarai probabilmente 
rimasto colpito. Anche se conversai) fa riferimento 
solo alla classe Persona, il codice che viene chiama- 
to non è necessariamente quello di Persona, ma 
quello del particolare oggetto che gli viene passato. 
Nel caso del Vecchietto, il codice di dailndicazio- 
niPerQ è lo stesso di Persona, ma salutaO e ricevi- 
InsultoQ sono cambiati. Quindi il metodo conversai) 
si comporta in modo diverso nei due casi. 
Questo è un esempio di polimorfismo. Polimorfico, 
in greco, significa "che assume diverse forme". I me- 
todi salutai) e ricevilnsultoQ sono polimorfici, cioè 
assumono forme diverse nelle varie classi imparen- 
tate. Di riflesso il metodo conversai) è polimorfico, 
perché si comporta in modo diverso a seconda del- 
l'oggetto che gli viene passato. 



SISTEMI 

CHE CRESCONO 

La cosa più importante del polimorfismo è che ti 
permette di scrivere programmi estensibili. Grazie al 
polimorfismo, un client è interessato a quello che gli 
oggetti fanno, ma non a come lo fanno. Con un pò ' di 
esperienza potrai sfruttare questa "ignoranza" per 
costruire programmi nei quali alcune funzionalità 
cambiano senza che il resto del programma debba 
essere modificato. Questo aspetto del polimorfismo 
funziona così bene che puoi inventare nuove sotto- 
classi di Persona anche dopo aver scritto il metodo 
conversai) e passarli al metodo. Tutto continuerà a 
funzionare tranquillamente, e conversai) resterà 
ignaro del fatto che i suoi parametri stanno facendo 
qualcosa di nuovo. 
Ecco la mia personale soluzione dell'Esercizio 1: 



System. out.println("Aho', vie' qua che te rompo!"); } 



Se passi un Coatto a conversa) otterrai: 



> Buongiorno! 
Ciao tipo! 

> Sto cercando Via Larga... 

Per andare in Via Larga si deve girare in fondo a destra. 

> Ma vai a quel paese! 
Aho', vie' qua che te rompo! 



Nulla ci impedisce di estendere la gerarchia delle 
Persone su più livelli, cioè di ereditare da una classe 
che a sua volta eredita da un'altra classe: 

class VecchiettoSordo extends Vecchietto { 
public void daiIndicazioniPer(String destinazione) { 

System. out.println("Può ripetere, scusi?"); } 
public void riceviInsulto() { 

System. out.println("Eh?");} } 

Ecco risultato della conversazione con un Vec- 
chiettoSordo: 



> Buongiorno! 

I miei rispetti alla Sua sigr 

> Sto cercando Via Larga. 
Può' ripetere, scusi? 

> Ma vai a quel paese! 
Eh? 



In Fig. 2 puoi vedere la gerarchia delle Persone. 
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class Coatto extends Persona { 


public 


void saluta() { 




Syst 


Bm.out.println("Ciao tipo!"); 


} 


public 


void ricevilnsultoQ { 





Fig. 2: Il nuovo diagramma delle classi illustra bene i 
più livelli della gerarchia. 



VecchiettoSordo ridefinisce i metodi dailndicazioni- 
Per() e ricevilnsultoQ, ed eredita il resto dal suo più 
vicino antenato. Quindi riceve salutai) e passeggiai) 
da Vecchietto, e meditai) da Persona. Puoi fare l'"up- 
cast" di un VecchiettoSordo a Vecchietto oppure a 
Persona. 

Nel primo caso puoi usare ancora tutti i metodi del- 
l'oggetto, perché VecchiettoSordo non aggiunge me- 
todi all'interfaccia di Vecchietto; nel secondo caso il 
metodo passeggiai) diventa inaccessibile. 



SEPARARE 

CIO CHE E UNITO 

Ecco un esempio di come il polimorfismo può aiu- 





ESERCIZIO 1 



Scrivi una nuova classe 
che eredita da Persona. 
Ridefinisci solo alcuni 
metodi di Persona, a 
tuo piacimento. 
Crea un oggetto della 
classe e passalo al 
metodo conversai). 



GIOVANE E 
DINAMICO 

In alcuni linguaggi 
orientati agli oggetti, 
come il C++, si deve 
dire esplicitamente al 
compilatore quali 
metodi sono 
polimorfici e quali no. 
Se dichiari che un 
metodo è 
potenzialmente 
polimorfico (cioè che 
una sottoclasse può 
cambiarne il codice), 
allora il compilatore lo 
tratta in modo diverso 
dai normali metodi - 
cioè usa il binding 
dinamico. In Java 
questa distinzione non 
esiste: tutti i binding 
sono dinamici, quindi 
tutti i metodi sono 
potenzialmente 
polimorfici. 
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ANIMALI 
COSTOSI 

Nella gerarchia della 

classe Animale ho 

definito un metodo 

specieQ che restituisce 

il nome dell'animale. 

Ma subito è sorto un 

problema: è chiaro 

quello che il metodo 

deve restituire nelle 

sottoclassi ["cane" per 

Cane, eccetera), ma 

non so bene cosa 

restituire 

nell'implementazione 

della superclasse 

Animale. Qual è la 

specie di un generico 

Animale? Avrai un 

problema simile 

quando risolverai 

l'Esercizio 2 e dovrai 

scrivere il metodo 

Animale. prezzoQ. 



ESERCIZIO 2 



Implementa il metodo 

prezzoO nella gerarchia 

Animale. Fai girare il 

programma, e verifica 

che il risultato sia 

corretto. 





ESERCIZIO 3 



Aggiungi nuovi 

Animali alla gerarchia, 

e passali attraverso il 

metodo accreditai). 

Verifica che il metodo 

funzioni con qualsiasi 

Animale. Se porti il 

programma fuori dal 

main() puoi addirittura 

aggiungere nuovi 

Animali e passarli al 

metodo senza 

ricompilare la classe 

Cassa3. 



tarti a "disaccoppiare" le diverse parti del tuo pro- 
gramma per renderlo più flessibile. 
Guarda questo codice: 

// la cassa di un negozio di animali 

class Cassai { 

private long _totale; 
public void accredita(String animale) { 
if(animale.equals("pappagallo")) 

_totale += 10; 

else if (animale. equals("cane")) 

_totale += 5; 
else if (animale. equals("muf Ione")) 

_totale += 25;} 

public static void main(String[] args) { 
Cassai cassa = new Cassal(); 
cassa. accredita("pappagallo"); 
cassa. accredita("cane"); 
cassa. accredita("cane"); 

System. out.println("TOT: " + cassa. _totale); } 
} 

Ho usato l'operatore '+='per incrementare il campo 
privato Jotale. Nota che Cassai include il proprio 
mainO di test, che fa la parte del client. Immagina 
che il mainO sia un programma complicato che usa 
la classe Cassai. Nota anche che il mainO può acce- 
dere al campo totale anche se è privato, perché fa 
parte della stessa classe. Per ottenere il totale dall'e- 
sterno potresti scrivere un metodo totaleO che resti- 
tuisce il valore del campo senza esporre il campo 
stesso ai client. Cosa ne pensi di questo programma? 
Sicuramente funziona (e stampa come risultato 20), 
ma personalmente lo trovo decisamente bruttino. 
Nonostante le sue minuscole dimensioni, il pro- 
gramma è poco estensibile. Se decidi di aggiungere 
un animale allora devi intervenire in due punti: devi 
creare una nuova classe che eredita da Animale, e 
devi anche modificare il metodo accreditaQ perché 
riconosca il nuovo animale e lo aggiunga al conto. 
Questo è un modo quasi garantito per introdurre dei 
bug nel codice: quando i metodi che usano gli ani- 
mali sono centinaia, e tutti contengono catene di 
istruzioni condizionali come quelle di accreditaQ, è 
facilissimo dimenticarsi di modificare uno dei meto- 
di quando si introducono nuovi elementi nel pro- 
gramma, o sbagliare nello scrivere una delle stringhe 
(che appaiono tutte in almeno due punti). Come 
primo passo vorrei trasformare il parametro di ac- 
creditaQ in una gerarchia di oggetti. Ecco una secon- 
da versione del programma, che sfrutta il polimorfi- 
smo: 

class Animale { 

public String specie() { 
return "";} } 
class Cane extends Animale { 

public String specieQ { 



return "cane"; } } 
class Pappagallo extends Animale { 
public String specie() { 
return "pappagallo"; } } 
class Muflone extends Animale { 
public String specie() { 
return "muflone"; } } 
class Cassa2 { 
private long Jotale; 

public void accredita(Animale acquisto) { 
if(acquisto.specie().equals("pappagallo")) 

_totale += 10; 

else if (acquisto. specieQ. equals("cane")) 

_totale += 5; 

else if (acquisto. specieQ. equals("muf Ione")) 

_totale += 25; } 

public static void main(String[] args) { 
Cassa2 cassa = new Cassa2(); 
cassa. accredita( new PappagalloQ); 
cassa. accredita(new CaneQ); 
cassa. accredita(new CaneQ); 
System. out.println("TOT: " + cassa. _totale);} 
} 

Ora i nomi degli animali sono stati trasferiti nella 
gerarchia di oggetti attraverso il metodo polimorfico 
specieQ. I nostri problemi di duplicazione non sono 
ancora risolti. Però ora abbiamo una struttura ad 
oggetti, e possiamo eliminare quelle brutte istruzio- 
ni if a colpi di polimorfismo. La classe Cassa2 deve 
continuamente mettere le mani negli oggetti della 
gerarchia Animale, estrarne dei dati, e in base a que- 
sti dati prendere delle decisioni. Pare che la com- 
plessità del nostro programmino sia il sintomo di un 
problema di design: la classe Cassa2 si sta assumen- 
do delle responsabilità che dovrebbero appartenere 
direttamente agli Animali. In particolare, fa tutto 
questo per calcolare prezzo dei singoli animali. 
Allora, perché non creare un metodo prezzoQ diret- 
tamente nella classe Animale? Così ciascun animale 
potrà calcolare autonomamente il proprio prezzo, e 
la cassa deve solo leggerlo e aggiungerlo al totale: 



class Cassa3 { 


private long _totale; 


public void accredita(Animale acqui 


sto){ 


Jotale += acquisto. prezzoQ; } 


public static void main(String[] arg 


s) { 


// (uguale a quello di Cassa2) } 


} 



Ora sì, che mi piace! 

Spero che tu sia soddisfatto di quello che hai impa- 
rato questo mese. Ma non dormiremo sugli allori: 
mese venturo ti aspettano altri aspetti dell'eredita- 
rietà e del polimorfismo - e questa volta farai una 
scorpacciata di nuove parole chiave. A presto! 

Paolo Perrotta 
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Impariamo a proteggerci dagli hacker 



La crittografia 
con CAPICOM 

Utilizzando un controllo Activex per la CryptoAPI, descriviamo 
come incorporare la firma digitale, o elettronica, 
e la crittografia nelle applicazioni Visual Basic. 



Il termine PKI (Public Key Infrastrutture), viene 
utilizzato per descrivere tutto ciò che riguarda 
l'autenticazione degli utenti e la sicurezza sulla 
rete. PKI, dunque, ingloba i software di crittografia e 
quelli che amministrano i certificati digitali e le 
chiavi pubbliche e private. In altre parole il PKI si 
preoccupa di proteggere dati sensibili e garantisce 
sui componenti software utilizzati. I servizi di sicu- 
rezza basati sulla crittografia, vengono divisi in 
quattro rami: crittografia a chiave privata (crittogra- 
fia simmetrica), crittografia a chiave pubblica (crit- 
tografia asimmetrica), firma di crittografia e hash di 
crittografia. In Windows i componenti che permet- 
tono agli sviluppatori di utilizzare i servizi di sicu- 
rezza crittografica sono: CryptoAPI e Cryptographic 
Service Providers (CSP). In Visual Basic queste fun- 
zionalità possono essere incorporate utilizzando 
CAPICOM (cioè CryptoAPI COM). In questo artico- 
lo descriveremo come implementare un'applicazio- 
ne (Client) che utilizza i servizi di crittografia di 
Windows, in particolare descriveremo come critto- 
grafare/decrittare un testo (file o stringa), come uti- 
lizzare i certificati digitali, per "firmare" (garantire) il 
contenuto di un file, e vari concetti, sull'information 
security, che orbitano intorno a questi argomenti. 



CryptoAPI E CSP 

La CryptoAPI è un insieme di API (Application Pro- 
gramming Interfacce) che consentono di inserire, 
nelle applicazioni Win32-based, le funzionalità per 
la messa in sicurezza del software e delle trasmissio- 
ne dati. In particolare permettono di utilizzare i ser- 
vizi di autenticazione, di crittografìa, di hash, di 
codifica e decodifica e di enveloping messages (im- 
bustare dei documenti). La CryptoAPI aderisce allo 
standard PKCS #7 della RSA per quanto riguarda 
l'envelopment message, consente di codificare e de- 



codificare i dati con ASN. 1 (Abstract Syntax Notation 
One) e di amministrare certificati strutturati secon- 
do lo standard X.509. La CryptoAPI con una partico- 
lare tecnica permette di verificare automaticamente 
i certificati avvalendosi di una lista di certificati 
attendibili. I CSP (Cryptographic Service Providers), 
invece, sono i provider dei servizi di crittografia. 
I CSP implementano i servizi della CryptoAPI, for- 
niscono algoritmi di crittografia più robusti. 
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Fig. 1: In figura è mostrato il forni dell'applicazione. 

La crittografia 
con CAPICOM 

CAPICOM è un Activex che fornisce un'interfaccia 
COM alla CryptoAPI, quindi consente di estendere i 
servizi di sicurezza di Windows a Visual Basic (Vb- 
Script, ASP C++, ...). CAPICOM non aggiunge altre 
funzionalità alle CryptoAPI ma le utilizza anche se 
con alcune limitazioni. Per esempio anche se Cryp- 
toAPI supporta vari algoritmi di hash, CAPICOM, 
per le firme, può utilizzare solo SHA-1. Inoltre c'è da 
specificare che i dati crittografati con CAPICOM 
possono essere letti solo con un'altra applicazione 
implementata con CAPICOM. Sottigliezze a parte 
CAPICOM può essere utilizzato per amministrare i 
certificati e le firme digitali, per l'envelop dei dati, 
per crittografare e decrittare e per varie altre cose. 
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~ Elementi Visual Basic 
per la gestione dei file, 
delle stringhe e degli 
Activex. 



Windows 98 o 
superiore, Visual Basic 
6 SP6 - Activex MS 
CAPICOM 2.0.0.3 
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Fig. 2: Un esempio di 
certificato generato con 
SelfCert.EXE di Office. 




SSL 

SSL è il più comune 

protocollo (client 

/server) di sicurezza 

adoperato sulla rete; 

esso, per proteggere i 

dati, utilizza una 

combinazione di 

certificati digitali 

(chiavi pubbliche/ 

private) e crittografia 

(a 128 bit). I certificati 

ammessi possono 

essere sviluppati 

secondo vari standard, 

tra cui lo standard 

X.509. 
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Fig. 2: La finestra di Internet Explorer che permette 
di gestire i certificati. 



CERTIFICATO 
DIGITALE 

Come accennato i certificati digitali (la "firma digita- 
le") servono per rendere sicuri i componenti Softwa- 
re e, in generale, le comunicazioni su Internet. Un 
certificato digitale garantisce che un componente 
Software proviene da una fonte attendibile, certifi- 
cata da un'autorità di certificazione (CA) riconosciu- 
ta. In parole povere il certificato elettronico (o digi- 
tale) è una sorta di carta d'identità per Internet e la 
CA è "l'ufficio anagrafico". Un certificato digitale di 
solito contiene le seguenti informazioni: la chiave 
pubblica e le generalità del possessore cioè nome e 
cognome (se il possessore è una persona fisica) l'in- 
dirizzo e il nome della compagnia (quando invece si 
tratta di un server web); la data di scadenza della 
chiave pubblica (come nel caso della carta d'identità 
c'è una scadenza!) e il nome e la firma digitale della 
autorità di certificazione. In seguito vedremo che la 
chiave pubblica, e quella privata, servono per critto- 
grafare e decrittare un dato (messaggio, file ecc.). 
Sintetizzando, chi invia un messaggio lo cifra con la 
chiave pubblica del destinatario e quest'ultimo può 
leggerlo solo decodificandolo con la sua chiave pri- 
vata (che in ogni caso resta segreta). Internet Explo- 
rer permette di controllare la lista dei certificati, e la 
lista dei CA di fiducia (Trusted CAs) presenti sul com- 
puter. Questo può essere fatto utilizzando il pulsan- 
te "Certificati" presente sulla scheda contenuto 
(Content Tab) della maschera Opzioni Internet. 
Internet Explorer, per proteggere il computer, prima 
del Download di un programma ne verifica l'identità 
attraverso la tecnologia Authenticode, cioè verifica 
se il programma, che si vuole scaricare, abbia un 
certificato elettronico valido che sia stato rilasciato 
da un'autorità riconosciuta e non sia ancora scadu- 
to. Una cosa analoga succede quando ci si collega ad 
un sito protetto (quelli che iniziano con https invece 
che con http); il sito invia al navigatore il suo certifi- 
cato in modo da essere riconosciuto ed assicurare 
che i dati sensibili, che 
saranno forniti, non ver- 
ranno letti e modificati 
da altri. Dunque un certi- 
ficato digitale, personale 
o di un sito, associa una 
chiave pubblica e una 
privata ad un'identità. La 
chiave privata, conosciu- 
ta solo dal proprietario, 
consente di porre una 
"firma digitale" o decrit- 
tare dei dati che qualcun 
altro ha crittografato uti- 
lizzando la sua chiave 
pubblica (nota a chiun- 
que). Naturalmente tra 
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chiave pubblica e privata c'è un legame deducibile 
attraverso un algoritmo matematico! Per gli esempi 
che presentiamo in questo articolo, potete creare dei 
certificati temporanei (validi solo sul vostro compu- 
ter) attraverso i tool SelfCert.EXE o MakeCert.exe, 
che trovate nel sistema operativo o che potete scari- 
care dal sito della Microsoft. 



INSTALLAZIONE 
CAPICOM 



L'ultima release di CAPICOM è la 2.0.0.3 che può 
essere scaricata dal sito Microsoft. Essa è contenuta 
nel pacchetto CAPICOM.EXE. Questo contiene vari 
file (per esempio CAPICOM.CAS) e alcuni esempi 
pratici di utilizzo per i vari linguaggi supportati. 
Per installare CAPICOM sul vostro computer, biso- 
gna estrarre CAPICOM.DLL, dal file CAPICOM .CAB 
(che si trova nella directory /.../CAPICOM 1x861), e 
poi registrarla, utilizzando regsvr32 .exe, con la se- 
guente: 

regsvr32.exe CAPICOM.DLL 

Naturalmente prima bisogna individuare la direc- 
tory in cui è contenuto il file (che potrebbe essere 
I...ICAPICOMIx86l ). Nella Tabella 1 abbiamo rias- 
sunto le categorie in cui sono raggruppati gli ogget- 
ti, le interfacce ed i tipi che si possono gestire con 
CAPICOM. Di seguito descriveremo come utilizzare 
CAPICOM e introdurremo un'applicazione che con- 
sente di crittografare/ decrittare una stringa (o un 
file), di mostrare i certificati elettronici presenti sul 
computer, di firmare il contenuto di un file e di 
imbustare un messaggio da trasmettere. 



USO DI CAPICOM 

Create un nuovo progetto EXE e referenziate la libre- 
ria CAPICOM.DLL, sulla form inserire degli oggetti 
che vi permettono di ricercare un file (un textbox, un 
Common Dialog ed un pulsante), una listbox (che 
utilizzeremo per mostrare i certificati digitali) e di- 
versi pulsanti per abilitare i vari esempi che presen- 
teremo. Prima di implementare gli esempi bisogna 
capire come sono organizzati i certificati registrati 
nel nostro computer. I certificati sono raggruppati in 
Store (quindi sono amministrabili attraverso gli 
oggetti della categoria Certificate Store) permanenti 
o temporanei, questi ultimi (presenti solo in memo- 
ria centrale) sono necessari, quando non si vogliono 
archiviare alcuni certificati negli store permanenti. 
Di solito in Windows sono definiti 3 store: MY (con- 
tenente i certificati dell'utente), Root e CA. 
Ora possiamo descrivere il codice che mostra in una 
listbox i certificati di MY store. 




Visual Basic 
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COME MOSTRARE 
I CERTIFICATI 

Nella procedura per mostrare i certificati utilizzere- 
mo i seguenti oggetti. 

1. Store che fornisce i metodi per scegliere ed am- 
ministrare i certificati negli Store. Esso tra l'altro 
presenta la proprietà Certifìcations che permette 
di selezionare la collezione di Certificate nello 
Store. 

2. Certificate che rappresenta un singolo certifica- 
to digitale, permette di caricare il certificato da 
un file, determinare la validità del certificato, 
ecc. 

La procedura per mostrare i certificati è la seguente 
(nel CD allegato alla rivista troverete un esempio più 
semplice). 

Private Sub VisualizzaCerti_Click() 

Dim objStore As New CAPICOM. Store 

Dim objCertificate As CAPICOM. Certificate 

Listi. Clear 
objStore. Open 

For Each objCertificate In objStore. Certificates 
Listi. Addltem objCertificate. SubjectName &_ 
" Valido dal " + CStr(objCertificate.ValidFromDate) & _ 

" al " + CStr(objCertificate.ValidToDate) 

Next 

End Sub 

In essa per aprire uno Store utilizziamo il metodo 
Open che ha tre parametri opzionali. 
La sintassi di Open è 

Open (StoreLocation, StoreName, OpenMode) 

Il parametro StoreLocation indica il tipo e la location 
dello Store (memoria centrale, store dell'utente cor- 
rente, local-machine, Active Directory ecc.), il valore 
che utilizziamo nella procedura è quello di default 
cioè CURRENT_USER_STORE. StoreName, invece, è 
il nome dello Store che deve essere aperto, il suo va- 
lore di default è My Store (CAPICOM JAY _STORE). 
Infine OpenMode indica in che modo lo Store deve 
essere aperta, il suo valore di default è CAPICOM_ 
STORE_OPEN_EXISTING_ONLY (apri lo store solo 
in lettura) . Dell'oggetto Certification invece utilizzia- 
mo le proprietà: SubjectName che fornisce il nome 
del titolare del certificato; ValidFromDate la data d'i- 
nizio validità e ValidToDate data di fine validità. 



FIRMARE UHI FILE 

Con il successivo esempio vedremo come "firmare" 



un file. Gli elementi di CAPICOM che utilizzeremo /jjj 
sono: 

• SignedData, l'oggetto che permette di stabilire il 
contenuto (content) che deve essere firmato o 
verificato dopo la firma digitale; 

• Signer, l'oggetto che permette di stabilire il fir- 
matario (Signer) di un SignedData e che tra l'al- 
tro fornisce la collezione AuthenticatedAttributes 
di attributi di certificazione; 

• Attribute, questo oggetto fa parte degli oggetti 
ausiliari e serve per fissare un singolo attributo 
di autenticazione. 




Categoria 


Descrizione 


Certificate Store 


L'insieme degli oggetti che permettono di amministrare i 
certificati archiviati (negli Store) 


Digital Signature 


Oggetti usati per amministrare la firma digitale dei dati 


Enveloped Data 


Oggetti che possono essere usati per l'enveloped data 
messages ("imbustare i dati") e per il decrypt dei dati 
"imbustati" 


Data Encryption 


Gli oggetti per crittografare/ decrittare i dati 


Oggetti accessori 


Oggetti che permettono di svolgere diverse attività accessorie 
come: cambiare le caratteristiche di default, amministrare 
gli attributi dei certificati ecc. 


Interoperability Interfaces 


Interfacce che consentono ai derivati di CryptoAPI di 
lavorare insieme a CAPICOM 


Enumeration Types 


Tipi enumerativi utilizzati con CAPICOM 


, TABELLA 1 - 1 principali elementi di CAPICOM. 



Prima di presentare la procedura facciamo notare 
che in essa non abbiamo incluso il codice che, attra- 
verso un Common Dialog, permette di selezionare il 
file da firmare inserendo il suo nome e il path nel 
textbox txtfllename. Inoltre, notate che per selezio- 
nare un certificato utilizziamo la procedura Scegli- 
Certificato e che il file firmato è salvato con il nome 
"firmato"+"nomefileoriginarìo". 

Private Sub firma_Click() 

On Error GoTo errore 

Dim cont As String 

Dim sig As String 

Dim Signedobj As New SignedData 

Dim Signer As New Signer 

Dim TempoSign As New CAPICOM. Attribute 

If ScegliCertificato(Signer) Then 

Else 

MsgBox "selezionare un certificato" 
Exit Sub 

End If 

Open txtfilename For Input As #1 

Input #1, cont 

Close #1 

Signedobj. Content = cont 

TempoSign. Name = CAPICOM_AUTHENTICATED_ 
ATTRIBUTE_SIGNING_TIME 

TempoSign. Value = Now 

Signer. AuthenticatedAttributes. Add TempoSign 



TIPI 

DI CERTIFICATI 

Con Internet Explorer 
sono utilizzati due tipi 
di certificati: personali 
e di sito Web. Il primo 
tipo attesta l'identità 
di un utente ed è usato 
per inviare informazio- 
ni personali ad un sito, 
quando questo le ri- 
chiede. Questi certifi- 
cati per esempio 
possono essere richie- 
sti dal sito di un'ammi- 
nistrazioni pubblica o 
di un ufficio postale. Il 
"certificato di sito 
Web", invece, attesta 
l'autenticità e la 
protezione di un sito 
Web. Questi sono 
soprattutto utilizzati 
da siti che amministra- 
no dati sensibili: 
banche, uffici postali, 
siti di commercio 
elettronica, ecc. 
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Per saperne di più sui 

certificati digitali 

potete collegarvi ai 

seguenti siti: 

http://thawte.ascia.net 

(trovate informazioni 

in italiano) e 

http://www.verisign.com . 

Quest'ultimo è il sito di 

una delle più 

importanti autorità di 

certificazione mondiali. 

Se invece cercate più 

informazioni su ASN.1 

collegatevi a 

http://www.rsa.com . 



sig = Signedobj.sign(Signer, True) 

Dim path As String 

Dim pos As Integer 

pos = InStr(CommonDialogl.filename, 

Common Dialogl.FileTitle) 
path = Mid(CommonDialogl.filename, 1, pos - 1) 
Alenarne = path + "firmato" + CommonDialogl.FileTitle 
Open filename For Output As #2 

Write #2, sig 

Close #2 

MsgBox "Firmato il file: " + CommonDialogl.FileTitle 
Set Signedobj = Nothing 
Set Signer = Nothing 
Set TempoSign = Nothing 
Exit Sub 
errore: 
If Err.Number > Then 

MsgBox "Errore VB " & Err.Description 

Else 

MsgBox "Errore CAPICOM " & Err.Number 

End If 

End Sub 

Function ScegliCertificato(obj As Signer) As Boolean 

Dim objStore As New CAPICOM. Store 

objStore.Open 
For i = To Listi. ListCount - 1 

If Listi. Selected(i) Then 

obj. Certificate = objStore. Certificates.Item(i) 
ScegliCertificato = True 

End If 

Next i 

'bisogna inserire le istruzioni per verificare 
'la validità del certificato 
End Function 

Nella FirmajClick, dopo aver caricato in Signer il 
certificato selezionato sulla ListBox, si apre il file che 
si vuole firmare e il contenuto viene inserito nella 
stringa cont. Con l'istruzione successiva, utilizzando 
la proprietà Content, s'imposta l'oggetto SignerData. 
Utilizzando l'attributo, invece, si imposta l'ora e 
giorno in cui viene firmato il documento, successi- 
vamente il valore dell'attributo viene impostato 
nella collezione di attributi del Signer. Infine viene 
firmato il documento attraverso il metodo sign del- 
l'oggetto SignedData. Facciamo notare che, con la 
firma digitale, si esegue l'hash del dato da firmare, 
crittografandolo, usando la chiave privata contenu- 
ta nel certificato. Il secondo argomento del metodo 
Sign è bDetached, un valore che specifica (quando è 
True) che la firma e il dato da firmare non sono nello 
stesso documento; quindi, in questo caso, chi deve 
verificare la firma deve avere una copia del docu- 
mento firmato. Invece, per verificare un documento 
firmato possiamo usare la seguente procedura. 

Private Sub verificafirma_Click() 
On Error GoTo error 



Dim Cont As String 

Dim ContFirmato As String 

Dim Signdata As New SignedData 

Dim path As String 

Dim pos As Integer 

pos = InStr(CommonDialogl. filename, 

CommonDialogl.FileTitle) 
path = Mid(CommonDialogl. filename, 1, pos - 1) 
filename = path + "firmato" + CommonDialogl.FileTitle 
'apre file firmato 
Open filename For Input As #1 
Input #1, ContFirmato 

Close #1 

'apre file originale 

Open txtfilename For Input As #2 

Input #2, Cont 

Close #2 

Signdata. Content = Cont 
On Error Resumé Next 
Signdata. Verify ContFirmato, True 
If Err.Number <> Then 

MsgBox "Errore nella verifica" & Err.Description 
Else 

MsgBox "Verifica completata" 

End If 

Exit Sub 
error: 
If Err.Number > Then 

MsgBox "Errore di VB: " & Err.Description 
Else 

MsgBox "Errore di CAPICOM: " & Hex(Err.Number) 

End If 

End Sub 

La procedura precedente verifica la correttezza della 
fuma, nell'ipotesi che il contenuto del documento e 
la firma non siano nello stesso file (cioè parametro 
bDetached=True). Infatti, vengono caricati due file, 
quello da firmare e la firma. Il primo è caricato in 
Signdata.Content, il secondo nella variabile Cont- 
Firmato che successivamente viene passata al meto- 
do Verify dell'oggetto SignedData. Per eseguire que- 
ste operazioni correttamente il certificato deve esse- 
re attendibile (cioè installato nell'archivio delle au- 
torità di certificazione). 



CONCLUSIONI 

In questo articolo abbiamo introdotto le tecnologie 
alla base dell'infrastruttura a chiave pubblica (PKI), 
fondamentale per le applicazioni che prevedono un 
sistema di protezione distribuito, in cui i partecipan- 
ti non fanno parte della stessa rete. Nel CD troverete 
degli esempi su come crittografare e decrittare un 
dato, e il codice degli esempi (algoritmo di hash) che 
abbiamo presentato nel precedente appuntamento. 

Massimo Autiero 
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Microsoft Solutions Framework 3.0: principi fondamentali 

Otto regole per il 
successo dei progetti 

Il Solution Framework proposto da Microsoft si basa su otto semplici 
principi, dettati dall'esperienza e dal buon senso, che ci guidano 
nello sviluppo di soluzioni anche molto complesse. 



P Abbiamo già parlato di MSF v3.0 nel numero 
di Gennaio 2004 di ioProgrammo. Abbiamo 
visto come MSF ci guida nella definizione del 
team di lavoro (Team Model), nella gestione del pro- 
cesso (Process Model), e che contiene delle discipline 
per la gestione del progetto (Project Management), 
dei rischi (Risk Management) e delle competenze 
(Readiness Management). In questo articolo vedre- 
mo invece gli otto principi fondamentali di MSF. 
Questi principi non sono specifici di MSF, ma posso- 
no essere applicati anche ad altre metodologie, ad 
esempio RUP o le metodologie agili. 



SUDDIVIDETE 

LE RESPONSABILITÀ, 

DEFINITE I COMPITI 

Ogni persona del team in ogni ruolo è responsabile 
della riuscita del progetto. Il progetto non può fun- 
zionare se i membri del team non collaborano nel 
gestire la responsabilità. Questo è contrario al crede- 
re comune che il project/product manager deve 
"comandare" per la riuscita del progetto. Se i mem- 
bri del team non collaborano, il progetto è destinato 
al fallimento. Inoltre, se qualcuno si accorge che 
qualcosa non va, è suo preciso compito fare di tutto 
per cercare di risolvere il problema, in collaborazio- 
ne con gli altri. Se tutti fossero responsabili di tutto, 
il progetto sarebbe nel caos. Per questo, assieme al 
principio di suddivisione delle responsabilità, c'è il 
principio della chiara definizione dei compiti. Que- 
sto principio stabilisce che ci devono essere delle 
chiare figure di riferimento per i vari ruoli (sviluppo, 
test, user interface, etc...), figure che devono diven- 
tare i punti di riferimento per capire come sta 
andando il progetto. Questo principio è alla base del 
Team Model di MSF, dove ogni ruolo ha pari respon- 
sabilità ma compiti distinti e ben precisi. Ogni grup- 
po non è un isola indipendente: ognuno ha una vi- 
sione su tutto il progetto. 



"POTENZIATE" I 
MEMBRI DEL TEAM 

In un team di successo, tutti i membri hanno "il po- 
tere", temporaneamente e nelle aree in cui sono par- 
ticolarmente portati. Se ognuno si impegna ad otte- 
nere il massimo e a dare massimo, gli altri faranno 
lo stesso. Certamente anche team gestiti in maniera 
autoritaria dai capi progetto possono riuscire a por- 
tare a termine i progetti, ma al termine del progetto 
i membri del team non saranno cresciuti, e soprat- 
tutto il vero potenziale della soluzione non sarà ve- 
nuto alla luce, in quanto le persone non avranno 
avuto la possibilità di esprimere al massimo le loro 
potenzialità. L'attività di controllo è distribuita, e 
non è intesa come un'attività "poliziesca" da parte 
del capo progetto. 




"CONCENTRATEVI" 
SUL BUSINESS VALUE 

Questo principio è molto semplice. Bisogna concen- 
trarsi su quello che serve per massimizzare il valore 
del progetto. Bisogna concentrarsi su quello che 
serve per massimizzare il valore della soluzione. 
Attività che non hanno uno scopo preciso di "busi- 
ness", che non forniscono valore aggiunto ai clienti, 
(come dover utilizzare a tutti i costi una tecnologia 
inutile ma "alla moda"), por- 
tano sempre problemi, da 
slittamenti delle date di con- 
segna al mancato raggiungi- 
mento degli obiettivi mini- 
mi, fino alla cancellazione 
del progetto. I ruoli User Ex- 
perience e Product Manager 
rappresentano gli interessi 
dei clienti e degli utenti 
all'interno dei progetti. 
Inoltre il Process Model di Fig. 1: Team Model di 
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Fig. 2: Process Model di 
MSF - Fasi principali. 
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MSF comprende anche la fase di deployment della 
soluzione perché una soluzione fornisce valore di 
business solo quando è completamente fun- 
zionante e utilizzabile dagli utenti. 



LAVORATE PER UNA 
VISIONE COMUNE 

I membri del team non possono lavorare bene se 
non condividono una visione comune. La visione è 
un documento molto breve, non più di qualche pa- 
ragrafo, che contiene delle frasi chiare su quello che 
deve essere realizzato e sul Business Value della so- 
luzione. Senza una visione, comune i membri del 
team, i clienti e gli utenti potrebbero trovarsi in di- 
saccordo, durante lo svolgimento del progetto, sui 
punti cardine. Il documento di Vision aiuta a mante- 
nere chiara la strada. La visione non scende dal cie- 
lo, ma i membri del team, devono lavorarci assieme 
a clienti ed utenti, per identificarla e condividerla. La 
visione comune è ciò che guida i membri di un team 
MSF, è quello verso cui tutti devono tendere, e che 
serve ad armonizzare gli sforzi, le competenze, i 
compiti e le responsabilità. 



RIMANETE "AGILI", 

ASPETTATEVI 

IL CAMBIAMENTO 

Alla base di questo principio vi è il fatto che le cose 
cambiano. Il problema del modello di sviluppo a 
cascata è che si basa sul fatto che i presupposti e i 
requisiti del progetto non cambiano una volta stabi- 
lizzati. Questo non è vero neanche nei progetti più 
semplici. Per questo il Process Model di MSF prevede 
uno sviluppo basato su Release e Milestone, in cui il 
progetto può adattarsi all'evoluzione del contesto e 
dei requisiti. Il fatto di rilasciare spesso porta ad ave- 
re una conoscenza maggiore del sistema e degli im- 
patti di possibili modifiche. 

INCORAGGIATE 

UNA COMUNICAZIONE 

"APERTA" 

La maggior parte dei fallimenti nei progetti è dovuta 
alla mancanza di comunicazione nel team e tra il 
team e i manager. Generalmente, se un progetto fal- 
lisce non è una sorpresa per i membri del Team, che 
sanno come va il progetto, ma è una sorpresa per 
quei manager che non sanno ascoltare. La comuni- 
cazione deve essere aperta anche agli utenti, ai clien- 
ti, e a tutte le persone interessate al progetto. Il Team 
Model di MSF è basato sulla comunicazione tra i 
membri del team, e i ruoli di Program Manager, User 



Experìence, Release Manager e Testing hanno anche il 
compito di fungere da interfacce verso i clienti, gli 
utenti, gli amministratori di rete, l'help desk, etc. 



IMPARATE DA 
"OGNI" ESPERIENZA 

Bisogna imparare sia dai progetti e dalle attività an- 
date a buon fine sia, e soprattutto, da quelle andate 
male. Non si può imparare dalle proprie esperienze 
se si è sempre di corsa, e se non si ha il tempo di ana- 
lizzare l'andamento del progetto. In MSF dopo ogni 
Milestone ci sono sempre delle review pianificate di 
come è andata la Milestone, che culminano con il 
documentare cosa è andato bene e cosa è andato 
male, per utilizzarlo poi per la pianificazione delle 
Milestone o dei progetti futuri. L'imparare da "ogni" 
esperienza è quello che rende MSF un framework e 
non una metodologia. In MSF non esiste "la" strada 
da seguire, ma la strada il team la deve trovare appli- 
cando a MSF le proprie esperienze e il proprio modo 
di lavorare, cercando di ottenere il meglio. 



INVESTITE 
NELLA QUALITÀ 

La qualità deve essere un concetto sempre presente 
in tutte le fasi del progetto. Investire per avere dei 
Tester e delle persone addette alla User Experience 
durante l'analisi e il design del sistema, e non solo 
durante e dopo l'implementazione, porta a una 
migliore qualità dei requisiti, ad un design più adat- 
to a essere testato, a un'interfaccia utente migliore. 
Tutti gli elaborati previsti dalle varie fasi vanno testa- 
ti, non solo programma. Questo comporta la revi- 
sione periodica dei documenti, per mantenerli 
aggiornati e per adattarli a cambiamenti improvvisi. 
La presenza poi nel Process Model della fase di Sta- 
bilizzazione, dove non si implementano nuove fun- 
zionalità ma si sistemano i problemi presenti, la 
misurazione del numero di bachi aperti e risolti, la 
gestione del deployment fin dalle prime release, 
porta ad un notevole incremento della qualità. 



CONCLUSIONI 

Se qualche principio non vi trova favorevoli, è 
meglio individuare subito quali parti di MSF appli- 
cano quel principio per capire se quelle parti di MSF 
fanno per voi oppure no. Tutti questi principi hanno 
provato sul campo la loro utilità, e molti di loro sono 
interdipendenti. Applicandoli ai vostri progetti ot- 
terrete sicuramente dei risultati che tenderanno a 
migliorare continuamente nel tempo. 

Lorenzo Barbieri 
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I vantaggi delTAOP nelle applicazioni Java 

Tiirbo Java, 
grazie ad AspectJ 

Uno degli utilizzi che rivela appieno le potenzialità di AOP 

nello sviluppo delle applicazioni è il caching dei dati, che consente 

di ottimizzare le prestazioni del software. 
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Ly analisi delle performance delle applicazio- 
ni porta spesso ad evidenziare come deter- 
minate operazioni, particolarmente one- 
rose in termini di tempo, siano ottimizzabili tramite 
l'uso di tecniche di caching. Si tratta solitamente di 
operazioni che richiedono accesso a database, a ser- 
vizi remoti, oppure che consistono in elaborazioni 
particolaremente complesse, come avviene nel caso 
che è oggetto di studio in questo articolo: la trasfor- 
mazione di documenti xml tramite xsl. L'approccio 
tradizionale a questo problema consiste nello svi- 
luppare, o acquisire, un modulo di cache general- 
purpose e di gestire poi applicativamente le opera- 
zioni di caching dove necessario. Ciò si traduce in 
concreto nel dover inserire nel codice della propria 
applicazione, prima dell'invocazione delle funzioni, 
un controllo atto a verificare che non sia già stata 
eseguita in passato la medesima elaborazione, e la 
logica necessaria a memorizzare i risultati. Se questo 
tipo di soluzione è capace di indirizzare corretta- 
mente il problema del caching, un'analisi critica ci 
fa osservare che è necessario codificare esplicita- 
mente nel codice applicativo tutta la logica necessa- 
ria per reperire e magazzinare valori nella cache. 
Questo fatto è di per sé negativo, perché dà origine a 
codice 'misto' (si parla di tangled code) in cui si me- 
scola la logica di business con aspetti non funziona- 
li; risultato è una soluzione non flessibile, che non 
ci consente di applicare o rimuovere la funzionalità 
di caching dall'applicazione se non a prezzo di cam- 
biamenti del codice. 

La soluzione ideale, in linea di principio, dovrebbe 
consentire di codificare, in modo separato dalla logi- 
ca di business, il meccanismo di caching e poi appli- 
care in modo dichiarativo (cioè non all'interno del 
codice, ma in elementi separati) questo meccani- 
smo nei punti dove vogliamo metterlo in atto. Per 
arrivare a questa soluzione ottimale, la programma- 
zione ad oggetti non ci fornisce strumenti adeguati; 



è necessario un cambiamento radicale di paradig- 
ma, cambiamento reso possibile dalle Aspect 
Oriented Programming. 



AOP, uni APPROCCIO 
ALTERNATIVO 

LAspect Oriented Programming (AOP) è un paradig- 
ma di programmazione emergente che si contrap- 
pone e completa il tradizionale paradigma ad ogget- 
ti. Infatti, mentre quest'ultimo si propone di model- 
lizzare le applicazioni attraverso l'uso di oggetti, 
entità dotate di dati e comportamenti, 1A0P si pre- 
occupa di modellare i crosscutting concern, ovvero 
tutte quelle funzionalità che investono e sono utiliz- 
zate in modo trasversale in molti punti dell'applica- 
zione. Esempi tipici di crosscutting concern sono il 
logging, la misurazione delle performance, i control- 
li di autorizzazione, la gestione delle transazioni e, 
naturalmente, il caching dei dati. AOP offre la possi- 
bilità di modellare separatamente dal codice appli- 
cativo i crosscutting concern, consentendo di au- 
mentare la modularità del software e permettendo 
di aggiungere dichiarativamente (cioè all'esterno del 
codice applicativo) funzionalità ulteriori al software 
sviluppato. Essendo l'Aspect Oriented Programming 
un paradigma differente dalla programmazione ad 
oggetti, nel suo studio si incontra una terminolgia 
differente. Si parla quindi di 

• Join point, cioè 'punti' all'interno del flusso di un 
programma in cui possono essere inseriti dei 
crosscutting concern. La granularità di tali punti 
è variabile: si parla di esecuzione di un metodo, 
di utilizzo di un oggetto, di gestione di una ecce- 
zione. 

• Advice, ovvero codice che definisce il crosscut- 
ting concern. 
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• Aspect, l'unione di un advice con uno o più join 
point. L'aspect definisce quindi interamente 
l'applicazione di un crosscutting concern all'in- 
terno di un programma (ovvero l'unione del 
codice da eseguire e i punti dove deve essere ese- 
guito). 

Per applicare l'Aspect Oriented Programming allo 
sviluppo del software è necessario dotarsi di stru- 
menti appositi, in quanto i tradizionali compilatori 
non supportano questa modalità di lavoro; i tool che 
permettono di applicare AOP allo sviluppo software 
possono lavorare secondo due modalità: 

• post-processando il codice compilato; dopo aver 
generato gli eseguibili, questi sono processati dal 
compilatore Aspect Oriented che aggiunge i 
crosscutting concern direttamente all'interno 
degli eseguibili 

• eseguendo il weaving a runtime, ovvero ese- 
guendo i crosscutting concern quando necessa- 
rio senza la necessità di processare gli eseguibili 

Al momento esistono implementazioni di compila- 
tori Aspect Oriented per molti linguaggi; tra questi, 
Java offre una certa possibilità di scelta, con tre 
implementazioni particolarmente interessanti: 
AspectJ, JBossAOP e AspectWerkz. In questo articolo 
ci soffermeremo in particolare su AspectJ che, tra 
quelli citati, è sicuramente più documentato e 
conta la comunità più vasta. 



JOIN POINT 
E POINTCUT 

AspectJ offre un set completo di join point predefi- 
niti, che esprimono vari punti nell'esecuzione del 
codice in cui verranno poi inseriti i crosscutting con- 
cern; gli esempi a seguire faranno riferimento alla 
classe Point così definita: 



public class 


Point 












{ int x; 


int y; 


public 


vo 


d setX( 


nt 


newX) { 


x = 


newX 


} 


public 


int 


getX() 


{ 


return x 


} 






public 


vo 


d setY( 


nt 


newY) { 


y = 


newY; 


} 


public 


int 


getY() 


{ 


return y 


} } 







La sintassi per dichiarare i più comuni join point è la 
seguente 

• l'oggetto corrente è di tipo SomeType, espresso 
con this(someType) 

• esecuzione di un metodo, execution(void Point- 
.setX(int)) 

• chiamata di un metodo, callfvoid Point.setX(int)) 

• l'oggetto destinatario dell'elaborazione è di tipo 
SomeType, target(someType) 

• è in esecuzione un exception handler, handler( 
ArrayOutOfBoundsException) 

• gli argomenti di una chiamata a metodo sono xl, 
x2 e x3 args(xl,x2,x3) 




AspectJ: CONCETTI 
FONDAMENTALI 

AspectJ è un progetto volto ad adottare i benefici 
dell'Aspect Oriented Programming nella program- 
mazione in Java. Per la definizione di aspetti, join 
point e advice, AspectJ utilizza una sintassi propria, 
per certi versi simile a Java, ma che necessita di un 
certo periodo di apprendimento per essere padro- 
neggiata; tuttavia già con poche istruzioni si posso- 
no costruire delle soluzioni efficienti. Pur esistendo 
dei buoni testi sull'argomento, sul sito è disponibile 
una 'The AspectJ Programming Guide' che offre una 
spiegazione molto dettagliata della sintassi e di tutte 
le funzionalità utilizzabili, corredata da esempi di 
codice. In sintesi, per descrivere con AspectJ un 
crosscutting concern e la sua applicazione all'inter- 
no di un programma è necessario scrivere un aspect; 
l'aspect è l'entità principale (assimilabile alla classe 
della programmazione ad oggetti) entro la quale 
sono sempre presenti uno o più poincut, combina- 
zioni di join point che definiscono punti nell'esecu- 
zione dell'applicazione e uno o più advice, che defi- 
niscono i comportamenti da adottare in corrispon- 
denza dei pointcut. 



È sempre possibile, nella 
definizione di join point, 
utilizzare wildcard per 
poter dichiarare in modo 
conciso una serie di pun- 
ti nel codice. 

Volendo ad esempio 
indicare l'invocazione di 
qualsiasi metodo getter 
della classe Point scrive- 
remo 

call(* Point.get*(..)) 

















Esegui 
l'elaborazione 




Memorizzai risultati 
nella cache 


NO 
/Elab* 


■azione x. 












SI 




Cerca i risultati 



















Fig. 1: Logica di caching dei risultati di una 
elaborazione. 



In questa espressione notiamo l'uso della wildcard 
'*' che indica genericamente tutti i possibili valori 
assumibili nel contesto (quindi tutti i tipi ritornabili 
e tutti i metodi che iniziano per get), e della wildcard 
'..' che esprime come siano da considerare i metodi 
con qualsiasi numero e tipo di argomento. I join 
point costituiscono i mattoni fondamentali con cui 
è possibile, con AspectJ, definire i pointcut. I point- 
cut sono combinazioni logiche dei join point che 
definiscono i punti di esecuzione del codice in cui il 
tool inserirà gli advice. Una dichiarazione di point- 
cut è la seguente: 
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ASPECTJ 

Inizialmente 

sviluppato nel 1997 dal 

team Xerox PARC 

guidato da Gregor 

Kiczales (ancora oggi 

figura di riferimento 

del settore), ha 

cominciato a godere di 

una fama notevole 

negli ultimi anni con 

l'ingresso del progetto 

nel consorzio open 

source Eclipse. 

È un tool liberamente 

scaricabile dal sito 

http://eclipse.org/aspectl/ 

ed è integrabile in 

molti ambienti di 

sviluppo, primo tra 

tutti Eclipse. 



pointcut setter(): target(Point) && (call(void 

setX(int)) || call(void setY(int))); 

dove pointcut è la parola chiave riservata per indi- 
care la definizione di un pointcut, setterQ è l'identi- 
ficativo, e la parte che segue i due punti è la defini- 
zione espressa in termini dei joinpoint fondamen- 
tali. Nel caso sopra esposto, il pointcut si potrebbe 
esprimere come 'tutte le chiamate dei metodi void 
setX(int) e void setY(int) che operino su un oggetto 
di tipo Target'. Per garantire maggiore flessibilità ed 
ampliare gli scenari di utilizzo è possibile parame- 
trizzare i pointcut; ciò, così come avviene per i me- 
todi Java, ha lo scopo di rendere disponibile all'in- 
terno dell'advice alcuni valori che derivano dall'ap- 
plicazione. Supponiamo, riprendendo l'esempio 
precedente, di voler rendere disponibile l'oggetto 
Paint. Scriveremo quindi 

pointcut setter(Point p): target(p) && (call(void 

setX(int)) || call(void setY(int))); 

È importante notare che solo tre tipi di joinpoint 
fondamentali possono essere utilizzati per esporre 
oggetti come parametri: this, target e args. Volendo 
quindi esporre come parametro anche l'intero pas- 
sato nei setter scriveremo 

pointcut setter(Point p, int i): target(p) && args(i) && 
(call(void setX(int)) || call(void setY(int))); 



DEFINIAMO I 
COMPORTAMENTI: 
GLI ADVICE 
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Fig. 2: Schermata di Ajdt, l'ambiente di sviluppo 
integrato Aspectj-Eclipse. 



Dato un pointcut, si 
possono scrivere di- 
versi advice che de- 
finiscano i compor- 
tamenti che voglia- 
mo inserire. Ancora 
una volta, per defi- 
nire un advice, è 
necessaria una sin- 
tassi particolare che 
ci permetta di carat- 
terizzare meglio il 
posizionamento 
degli advice rispetto 
al pointcut. 

Ecco vari esempi di dichiarazioni di advice che 
utilizzano come riferimento l'ultimo pointcut 
esposto: 

• before(Point p, int i) : setter(p,i) {...} specifica un 
advice da eseguire prima del pointcut setter 

• after(Point p, int i) : setter(p,i) {...} specifica un 



advice da eseguire dopo il pointcut setter 
• around(Point p, int i) : setter (p, i) {...} specifica un 
advice da eseguire 'attorno' il pointcut setter 

In particolare, l'ultimo tipo di dichiarazione sarà 
utilizzata nell'esempio di caching che sarà esposto a 
breve. Il codice vero e proprio che descrive l'advice 
(abbreviato negli esempi precedenti in {...}) deve 
essere espresso in linguaggio Java, utilizzando even- 
tualmente gli oggetti messi a disposizione come ar- 
gomenti. Considerando consueto esempio si po- 
trebbe definire un advice così fatto: 

before(Point p, int i): setter(p, i) 

{ System. out.println("Viene invocato un setter"); 

System. out.println("Le coordinate prima 

dell'esecuzione sono: "+p.getX()+","+P-getY()); 

System. out.println("II valore inserito dall'utente è "+i); 



L'aspect, come detto in precedenza, è l'entità fonda- 
mentale che racchiude pointcut e advice. Non es- 
sendoci ulteriori indicazioni da dare in merito, di 
seguito è riportato l'esempio che racchiude il point- 
cut setter e l'advice esposto in precedenza. 

public aspect LoggingDeiSetter 

{ pointcut setter(Point p, int i): target(p)&& args(i) 

&& (call(void setX(int))||call(void setY(int))); 

before(Point p, int i): tre(p, i) 

{ System. out.println("Viene invocato un setter"); 
System. out.println("Le coordinate prima 

dell'esecuzione sono: "+p.getX()+","+p.getY()); 
System.out.println("II valore inserito dall'utente è"+i); }} 



UTILIZZO 

DEL COMPILATORE 

ASPECTJ 

Prima di procedere all'analisi dell'esempio princi- 
pale proposto in questo articolo, è necessario dare 
qualche indicazione in più su come utilizzare 
AspectJ. Come detto in precedenza, AspectJ offre un 
compilatore Aspect Oriented per Java: questo signi- 
fica che il codice della applicazione deve essere pri- 
ma compilato con javac come avviene di solito, e 
quindi processato dal tool ajc fornito da AspectJ. Si 
faccia riferimento al sito per tutti i dettagli relativi ad 
ajc. Per godere appieno delle potenzialità di AspectJ 
è però necessario disporre di un ambiente di svilup- 
po integrato. A ciò provvede il progetto Ajdt (sempre 
parte del consorzio Eclipse) che integra AspectJ con 
FIDE Eclipse, rendendo lo sviluppo agevole ed 
immediato. Grazie ad Ajdt è possibile compilare e 
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preprocessare il codice in un'unica passata, nonché 
disporre di varie viste grafiche che aiutano a capire 
dove gli aspetti sviluppati influiranno nel comporta- 
mento del codice. 



Ul\l SISTEMA DI 
CACHIMG CON ASPECTJ 

Veniamo ora all'esempio principale proposto in 
questo articolo. Supponiamo di avere una semplice 
applicazione di web publishing che provveda a ser- 
vire dei contenuti tramite il web; i contenuti sono 
memorizzati in file xml e, prima di essere spediti al 
client, vengono trasformati in html applicando un 
foglio di stile xsl. La struttura dell'applicazione pre- 
vede due semplici classi: 

• una servlet TransformerServlet, che riceve la 
richiesta dell'utente e identifica il contenuto 
richiesto 

• una classe XslTransformer che riceve dalla serv- 
let il nome del file xml da processare ed applica 
la trasformazione specificata nel file xsl di stile. 
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Fig. 3: Architettura della applicazione. 

Nella pratica si verifica che l'elaborazione xsl/xml è 
un processo poco performante, per cui è sensato 
pensare di dotare l'applicazione di un sistema di ca- 
ching che, prima di processare un file xml, controlla 
se l'elaborazione è già stata eseguita in precedenza 
e, in caso affermativo, ripropone la pagina html già 
generata. Il vantaggio di implementare con AspectJ 
questo requisito, come si vedrà in seguito, sta nel 
fatto che il codice dell'applicazione pre-esistente 
non viene modificato; verrà semplicemente descrit- 
to un aspetto ed applicato tramite il compilatore 
Aspect Oriented al codice esistente. Vediamo innan- 
zitutto le due classi che compongono l'applicazio- 
ne; la classe XslTransformer utilizza le API javax.xml 
per effettuare l'elaborazione dei file xml: 

public class XslTransformer 
r /** 

* Applica la trasformazione definita in fileXsl al 

contenuto di fileXml e invia il 

* risultato della trasformazione a writer 

*/ 

public void process(File fileXml, File fileXsl, Writer 

writer) throws TransformerException 



{ Templates templare = TransformerFactory.newInstance( 
).newTemplates(new StreamSource(fileXsl)); 
Transformer transformer = template.newTransformer(); 
transformer. tra nsform(new StreamSource( 

fileXml), new StreamResult(writer)); } 



} 



La servlet principale che gestisce il dialogo con gli 
utenti non è riportata per intero nell'articolo, ma 
può comunque essere trovata nel CD allegato alla ri- 
vista. In sintesi, il suo compito è ricavare dalla re- 
quest dell'utente il contenuto richiesto e fornirlo, 
dopo aver trasformato il file xml sorgente. Il metodo 
della servlet che esegue questa funzionalità è il 
seguente: 

/** 

* Invia il contenuto richiesto dopo aver applicato 

la trasformazione specificata dal 

* file XSL_FILE 

*/ 

public void inviaContenuto(String fileXml, 

HttpServIetResponse response) throws Exception 
{ long time = System. currentTimeMillis(); 

StringWriter sw = new StringWriter(); 

XslTransformer t = new XslTransformer(); 

t.process(getFile(fileXml), getFile(XSL_FILE), sw); 

response. getWriter().print(sw.toString()); 

time = System. currentTimeMillis() - time; 

System. out.println("Contenuto " + fileXml + " 

reso in " + time + " millisecondi"); 



} 



Queste due classi, assieme al descrittore della web 
application creata (web.xmt) in cui sia dichiarata e 
mappata correttamente la servlet, costituiscono un 
sistema di web publishing, minimale ma funzio- 
nante. Per testarlo è necessario effettuare il deploy 
della web application presente nel CD allegato in un 
servlet container (Jakarta Tomcat ad esempio) e 
quindi inviare una richiesta tramite un browser 
all'uri http://localhost:8080/publisher/provider?con- 
tent=mypage. Il risultato sarà simile a quello mo- 
strato in Fig. 4. L'applicazione inoltre scrive nella 
console alcuni dati interessanti, fra cui spicca il 
tempo (in millisecondi) necessario ad eseguire la 
trasformazione xml/xsl. Applicando quanto illustra- 
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TOOL 

ALTERNATIVI 
AD ASPECTJ 

AspectWerkz 
http://aspectwerkz 
.codehaus.org/ 
è un tool open source 
che fa parte della 
famiglia di progetti 
ospitati dal Codehaus 
http://www.codehaus.or. 
Il suo punto di forza è 
la capacità di 
effetturare il weaving 
degli aspetti a 
runtime, oltre che il 
post-processamento 
degli eseguibili. 
JBossAOP 
http://www.jboss.org/ 
developers/projects/ 
jboss/aop è invece un 
sottoprogetto del 
gruppo JBoss 
utilizzabile anche 
separatamente 
dall'omonimo 
application server. 



Fig. 4: Il sistema di web publishing in azione. 
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to in precedenza vogliamo ora sviluppare un aspet- 
to che permetta di effettuare il caching dei risultati 
delle operazioni di rendering al fine di ottimizzare i 
tempi di risposta a richieste ripetute di contenuti. 
Per prima cosa si tratta di definire il pointcut, che in 
questo caso possiamo indentificare come 'la chia- 
mata del metodo process della classe XslTransfor- 
mer'; utilizzando la sintassi di AspectJ questo si 
esprime con 

pointcut processatile xml, File xsl, Writer wr) : 

call(public * XslTransformer.process(..)) && 
args(xml,xsl,wr); 

Come si nota gli attributi File xml, File xsl, Writer wr 
sono stati esposti nel pointcut in modo da rendere 
disponibili i relativi valori nello sviluppo dell' advi- 
ce. Quest'ultimo utilizza una dichiarazione di tipo 
around, il che sta a significare che intercetta l'ese- 
cuzione del programma prima e dopo il pointcut. 
In un around advice il superamento del pointcut 
deve essere invocato esplicitamente con l'istruzio- 
ne proceed. 

void around(File input, File xsl, Writer wr): 

processa(input, xsl, wr) 
{ String cached = (String)cache.get(new 

Integer(input.hashCodeQ)); 

if (cached == nuli) 
{ proceed(input, xsl, wr); 
cache. put(new Integer( 

input. hashCode()),wr.toString()); 
return; 

_J 

else 

{ System. out.println("II contenuto è stato trovato 

nella cache"); 
try 

{ wr.write(cached); } 
catch (Throwable t) 
{ t.printStackTrace(); } 
return; 



} 



} 



Questo advice utilizza una semplice logica di ca- 
ching: 

• dato un file, ne calcola YhashCode e utilizza 
questo valore come chiave di ricerca in una 
HashMap che memorizzati tutti i file xml in 
precedenza trasformati 

• se il valore dell' hashCode non è individuato tra 
i dati memorizzati invoca l'esecuzione del 
pointcut con l'istruzione proceed, e quindi 
memorizza nella cache la coppia [hashCode, 
file trasformato) 

• se invece il valore deìì'hashCode è individuato 



tra i dati memorizzati non viene eseguito il 
pointcut ma direttamente scritto il valore in 
memoria. 

Dopo aver eseguito la compilazione con ajc dell'a- 
spetto comprendente il poincut e l'advice definiti 
in precedenza, la riesecuzione dell'applicazione 
mostra un sensibile miglioramento delle presta- 
zioni del sistema di web publishing quando sono 
presenti richieste ripetute di contenuti; dai log 
sulla console si può apprezzare come il tempo 
richiesto per per servire un contenuto presente in 
cache è pari a pochi millisecondi, mentre una tra- 
sformazione xml/xsl richiede un tempo nell'ordi- 
ne dei decimi di secondo. 

Se questo risultato non giunge inaspettato, è bene 
sottolineare ancora una volta il fatto che non è 
stato modificato il codice applicativo del sistema 
di web publishing, ma solo aggiunto un aspetto. 
Inoltre è possibile pensare a diverse migliorie al 
meccanismo di caching, in modo da rendere il 
sistema più flessibile e potente; in particolare, è 
facile generalizzare l'aspetto in modo tale da poter 
memorizzare qualsiasi tipo di dato, ottenendo così 
un meccanismo di caching applicabile in diversi 
punti del programma e completamente riusabile. 



CONCLUSIONI 

In questo articolo è stata esposta in estrema sinte- 
si una introduzione all'Aspect Oriented Program- 
ming e ad AspectJ, un tool che permette di appli- 
care l'AOP alle applicazioni Java. 
Trattandosi di un paradigma relativamente giova- 
ne, le possibilità che esso può introdurre nello svi- 
luppo del software non sono ancora del tutto 
esplorate. Tuttavia esistono già degli "aspetti stan- 
dard" che vengono implementati e impiegati nelle 
applicazioni commerciali per risolvere in maniera 
efficiente ed elegante comuni crosscutting con- 
cern come logging, caching, gestione delle ecce- 
zioni e problematiche di autorizzazione. 
Costruire un sistema di caching con AspectJ si è 
rivelato essere un lavoro abbastanza semplice, e ci 
ha consentito di aggiungere una nuova funziona- 
lità ad una applicazione di web publishing senza 
modificare alcuna parte di codice scritta in prece- 
denza. 

Proprio la capacità di separare in moduli specifici 
funzionalità solitamente sparse in decine di punti 
nel codice applicativo si configura come la carat- 
teristica "forte" dell'Aspect Oriented Program- 
ming che sta spingendo molti sviluppatori, ricer- 
catori ed aziende a cercare di approfondire ulte- 
riormente la materia e ad incorporare questo nuo- 
vo paradigma nei software dei prossimi anni. 

Filippo Diotalevi 
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Salvare e leggere dati con Java 2 



Un formato 'flessibile' 
per i file dati 

Completiamo "Raffaello" con le funzioni salva e apri 
Implementeremo un pacchetto che gestisce con semplicità file 
in grado di creare automaticamente il proprio formato. 



Questo mese, metteremo a punto gli ultimi 
dettagli di Raffaello, il programma di dise- 
gno che abbiamo creato nello scorso nume- 
ro. Porremo la nostra attenzione sulle classi di 
gestione dei file disponibili con la JDK 1.4 e vedremo 
come usarle per creare un pacchetto che ci permet- 
ta di leggere e scrivere file in modo estremamente 
semplice e garantendo un comodo sistema di gene- 
razione automatica del formato dei dati, con parti- 
colare attenzione ai problemi legati alla compatibi- 
lità fra versioni diverse dello stesso programma. 




Fig. 1: II programma con le nuove funzioni, accessibili 
attraverso il menu Documenti. 



STRUMENTI NATIVI 
DI GESTIONE DEI FILE 

Gli ideatori di Java hanno creato un sistema di 
gestione dei file basato su tre 'livelli', ai quali, nella 
JDK 1.4, ne è stato aggiunto un quarto. 

Primo livello: gli oggetti File. Questi rappresentano 
un indirizzo nel file system. La classe File offre pa- 
recchi metodi che permettono di gestire molteplici 
file system con lo stesso codice. 
Secondo livello: i 'flussi' ('stream'), classi che gesti- 
scono i comandi di sistema necessari per aprire e 
chiudere un file in lettura o scrittura. Noi useremo: 



File AllocationTable 



■ Indirizzo fisico 



Accesso fisico al 



FilelnputStream e FileOutputStream. Terzo livello: i 
buffer, ingredienti necessari per 'sistemare' in me- 
moria i dati, letti o da scrivere. Java ne mette a dispo- 
sizione molti ma noi useremo solo il ByteBuffer. In- 
fine abbiamo il nuovissimo quarto livello: il 'canale' 
o FileChannel. Questo oggetto rappresenta la me- 
moria locale del disco fisso, un buffer fisico dal quale 
passano tutti i dati in transito fra memoria centrale e 
file. L'introduzione di questo oggetto permette lo 
spostamento dei dati in piccoli gruppi lavorando fra 
buffer del disco e memoria centrale senza il costan- 
te coinvolgimento del 
supporto magnetico, ri- 
ducendo il numero di in- 
terazioni con esso, che 
sono le operazioni più 
lente nella gestione dei fi- 
le. Il sistema funziona in 
questo modo: si alloca un 
nuovo 'flusso' di dati con 
una new FilelnputStream 
(file); e/o una new File- 
OutputStreamffile); dove 
file è un File, l'indirizzo 
del file da utilizzare; se il 
flusso è stato allocato 
possiamo richiedergli il 
canale attraverso il meto- 
do getChannel. Effettuate le operazioni di lettura e/o 
scrittura si dovranno chiudere canale e flusso usan- 
do i rispettivi metodi dose; questo non solo libera le 
risorse ma effettua anche il flush del canale. 

Nota bene: Lo stream viene allocato solo se il file esi- 
ste: per creare un file si usa metodo createNewFile 
di File. Le operazioni di trasferimento dati si effet- 
tuano con la mediazione del buffer di memoria. Il 
ByteBuffer è un buffer di byte dedicato allo scopo. Il 
canale offre i metodi di lettura e scrittura canale.- 
readfbyteBuffer); e canale.write(byteBuffer);. Esso 
funziona in questo modo: viene creato richiamando 




Q CD Q WEB 

Raffaello2.zip 



Indirizzo logico del 



Buffer fisico del 
disco fsso 



Oggetti FileChannel 




Fig. 2: Strumenti di gestione file ed "oggetti 
fisici" di riferimento. 



m. 




REQUISITI 



U4.u.wum 



9 Nozioni base di Java 

U 



Necessaria una JDK 1.4. 
Preferibile l'uso di 
Edipse v.2. 1 o 
superiore. 

presente sul CD: J2SE, 
Edipse 3.0 



Tempo di realizzazione 



000 
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Package it. gadget.fi leFormat (ci. 



EFile 

-canalelngresso: FileChannel 

- canaleUscita: FileChannel 
-fiussoUscita: FileQutputStream 
-flussolngresso: FilelnputStream 

- ingresso: File 

- uscita: File 



+ put ( Buffe rizza b le): int 
+ g et ( Buffe rizza b le): void 
+■ closel nput() :boolean 
+ closeOutputj): boolean 
+ openlnput(File): boolean 
+■ openOutput(File): boolean 



Fig. 3: Oggetti ed interfacce pubbliche del 
pakage it.gatget.fileFormat. 



il metodo statico allocate(dimension) dove dimen- 
sion è la dimensione che dovrà avere. Ogni 
ByteBuffer ha due riferimenti interni: il primo posi- 
tion al momento della creazione punta all'inizio del 
buffer mentre il secondo limit si riferisce alla fine. 
Durante le operazioni di scrittura su buffer position 
avanza in modo da tenersi alla cella successiva 
air ultima scritta. Conclusa l'operazione di scrittura 
bisogna utilizzare il metodo flip per riposizionare 
position all'inizio del buffer; con- 
testualmente limit raggiunge la 
posizione successiva all'ultimo 
byte scritto. Ora è possibile leg- 
gere i dati contenuti fra position 
e limit. L'operazione descritta 
viene effettuata sempre: nelle 
operazioni di lettura, quando a 
riempire il buffer è il canale ed a 
leggerlo l'applicazione, e nelle 
operazioni di scrittura, allorché 
la situazione si capovolge. 



interface 
Buffehzzable 



+ getFileFormatData:FileFormatData 
+ beforeFileWriting : void 
+ afterFìleReading: void 



FileFormatData 



.:.■..■■■: 
^ FileFormatDatafStrinuil. ■■■". 

FileFormatData) 



Point2D 

Java definisce un tipo 
astratto Poìnt2D 
estendendo il quale 
sono stati creati 
Point2D.Double, 
Point2D.FIoat. 
L'estensione della clas- 
se prevede l'imple- 
mentazione del meto- 
do setLocation(dou- 
ble, doublé); e la defi- 
nizione delle coordina- 
te x ed y. 



vvv 

interface 
Bufferìzzable 



Fig. 4: Formato dei file proposto. 



IL MOSTRO PACKAGE 

Il nostro obiettivo principale sarà semplificare e la 
cosa più semplice che posso immaginare è una clas- 
se, che possiamo chiamare EFile, che mi fornisca i 
metodi openlnput(File), closelnputO, openOutput- 
(File), closeOutputQ, put(Object) e get(Object). I pri- 
mi quattro si scrivono senza troppe difficoltà, gli ul- 
timi due, semplicemente non si scrivono! È vero che 
Java garantisce un metodo nativo di scrittura di un 
oggetto su file, la cosiddetta "serializzazione", ma 
questo scrive su file tutti gli attributi dell'oggetto 
mentre noi vogliamo scegliere quali scrivere. Sarà 
necessaria un'interfaccia che ci fornisca dei metodi 
implementando i quali ogni oggetto possa 'prepa- 
rarsi' per la scrittura 
e riorganizzare i dati 
letti oltre che sceglie- 
re cosa leggere e scri- 
vere dal e sul file; sic- 
come letture e scrit- 
ture utilizzeranno un 
buffer, chiameremo 
l'interfaccia Bufferi- 
zable ed i metodi di 
EFile saranno put(- 
Bufferizable) e get(- 
Bufferizable). L'inter- 
faccia avrà questa 
forma: 
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public interface Bufferizable 

{ public FileFormatData getFileFormatData(); 

public void beforeFileWritingO; 

public void afterFileReadingO; } 



FORMATO DI UHI FILE 

Il problema più grosso nella gestione delle informa- 
zioni contenute nei file è che, una volta trasferite sul 
supporto magnetico, queste perdono la loro 'iden- 
tità': in altre parole non è più possibile distinguere il 
'tipo' originale dei dati. Questo significa che: o si se- 
gue una regola di preventiva 'dichiarazione' del tipo 
di dato memorizzato, la serializzazione utilizza que- 
sta strategia ed anche XML può considerarsene un 
esempio evoluto di impiego, oppure si stabilisce in 
quale ordine i dati contenuti nei nostri oggetti-in- 
formazione debbano essere trasferiti sul disco 
dichiarando, in questo caso, quanti byte vengano 
utilizzati per ciascun blocco di dati. Il secondo siste- 
ma è il meno 'amichevole' ma il più 'rispettoso' del 
sempre esiguo spazio libero dei dischi fissi e quindi 
sarà il sistema proposto per Raffaello. 



L'IDEA DELLA 
COMPATIBILITA 

Il secondo problema che ci siamo posti è garantire 
la massima compatibilità fra file scritti da diverse 
versioni dello stesso programma. Per cominciare 
vediamo il meccanismo base di creazione del for- 
mato: nel nostro esempio dobbiamo salvare i dati 
relativi al nostro foglio, quindi quelli del disegno, 
ovvero quelli dei percorsi, cioè quelli dei punti. 
Salvare i dati relativi al punto è piuttosto facile: si 
tratta delle due coordinate, due doublé di 8 byte cia- 
scuno, e di un carattere, 2 byte, che distingua i punti 
normali da quelli di controllo. Il formato di memo- 
rizzazione del punto sarà dunque 18, (valore di x), 
(valore di y), (carattere), dove 18 è la dimensione del 
blocco dei dati da memorizzare. Ma se esistesse una 
versione zero di Raffaello capace di gestire solo 
spezzate? Allora un file scritto con tale versione con- 
terrebbe punti di questo formato: 16, (valore di x), 
(valore di y). Non avrebbe avuto senso allora, l'ag- 
giunta di un carattere al dato. Ciò nondimeno la 
nuova versione dovrebbe essere in grado di gestire 
l'informazione presente nei vecchi file. Le spezzate 
siamo in grado di gestirle! Per capire meglio dichia- 
riamo un oggetto punto così come avremmo dovu- 
to dichiararlo nella precedente e mai esistita versio- 
ne del programma. Già che ci siamo: siamo sicuri 
che siano necessari dei doublé per le coordinate? I 
monitor ed i mouse non restituiscono coordinate 
con virgola ed un doublé è estremamente oneroso 
anche in termini di memoria utilizzata rispetto, ad 
esempio, ad un piccolo short. Chiamiamo la nuova 
(o vecchia?) classe PoiM2dShort. 

package it.graphic; 

import java.awt.Point; 

import java.awt.geom.Point2D; 
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public class Point2dShort extends Point2D 

{ short x=0, y=0; 

public Point2dShort(){} 

public Point2dShort(Point point) 

{ setLocation(point.x, point. y); } 

public Point2dShort(Point2d point) 

{ setLocation(point.x, point. y); } 

public void setLocation(double x, doublé y) 

{ this.x=(short)x; this.y=(short)y;} 

public doublé getX() { return x; } 

public doublé getY() { return y; } } 

Il formato di scrittura di questa classe sarà: 4, (valo- 
re di x) , (valore di y) dato che la short occupa due by- 
te. Ora modifichiamo Point2d facendogli estendere 
Point2dShort anziché Point2D.Double. Tutto funzio- 
na comunque, le coordinate short non creano pro- 
blemi, ma come sarà ora il formato di Point2cP. Per 
compatibilità dovrebbe essere: 4, (valore di x), (va- 
lore di y) ed anche a logica sembra corretto che lo 
sia, quando non è punto di controllo. Ma se è punto 
di controllo diventerà necessariamente 6, (valore di 
x), (valore diy), (carattere)! Schematizziamo la situa- 
zione in questo modo: la dimensione sarà sempre 
un numero e sempre dello stesso tipo, cambierà solo 
il valore, le coordinate sono sempre short e sono 
sempre due, carattere può esserci o non esserci. 
L'idea è quindi questa: creiamo un sistema che si 
preoccupi di recuperare il blocco di dati necessario 
nascondendo all'oggetto la dimensione dello stesso, 
quindi introduciamo sistemi di gestione diversi per i 
dati essenziali, le coordinate, ed i dati opzionali, il 
carattere. Allo scopo realizzeremo la classe FileFor- 
matData che ci permetterà di dichiarare l'elenco 
degli attributi da leggere/scrivere ed un oggetto For- 
matHandler che gestirà le operazioni di lettura e 
scrittura sfruttando un riferimento all'oggetto; que- 
st'ultima classe sarà estesa da FileFormat e Optio- 
nalData allo scopo di garantire la capacità di distin- 
guere fra dati necessari e dati opzionali. 



IL GESTORE 
DI FILE 

Ora abbiamo gli ingredienti necessari per definire i 
metodi get e put di EFile. 

public int put(Bufferizable object) throws Exception 
{ object. beforeFileWriting(); 
FileFormat ff=new FileFormat( 

object. getFileFormatDataQ, true); 
ff.setReference(object); 
int dimBuffer=ff.onBufferSize(), dimDato = 0; 

ByteBuffer b = ByteBuffer.allocate(dimBuffer); 

try 

{ ff.toBuffer(b); 

b.flip(); 



dimDato=canaleUscita.write(b); } 
catch (Exception e) { throw e; } 
return dimDato; }; 

Il metodo put richiede all'oggetto di prepararsi alla 
scrittura quindi crea ff, un oggetto FileFormat, dan- 
dogli come parametro il FileFormatData restituito 
dall'oggetto ed una variabile booleana indicante la 
necessità di un formato di scrittura. Dopo aver otte- 
nuto il riferimento all'oggetto, jjf diviene il solo inter- 
locutore: esso restituisce la dimensione del buffer 
necessaria e copia i dati sul buffer; a questo punto, 
effettuata la flip possiamo scrivere sul file. 

public void get(Bufferizable object) throws Exception 
{ FileFormat ff=new FileFormat( 

object. getFileFormatData(), false); 
ff.setReference(object); 
int dimDato = 0, dimFormato=ff.getHeaderType(); 

ByteBuffer b=null; 

try 

{ if (canaleIngresso.size()<dimFormato) 
{ //lancia l'eccezione// } 

ByteBuffer bb=ByteBuffer.allocate(dimFormato); 
canalelngresso.read(bb); 

bb.flipQ; 

switch (dimFormato) 

{ case FileFormat. BYTE: dimDato=bb.get(); break; 
case FileFormat. SHORT: dimDato = bb.getShort(); 

break; 
case FileFormat. INT: dimDato=bb.getInt(); break;} 
if (canaleIngresso.size()<dimDato) 
{ //lancia l'eccezione// } 

b=ByteBuffer.allocate(dimDato); 

canalelngresso.read(b); 

b.flipQ; 

ff.byBuffer(b); } 

catch (Exception e) { throw e; } 
object. afterFileReading(); } 



Il metodo get è un po' più com- 
plesso: per cominciare crea ff 
indicando la necessità che sia 
un formato di lettura, quindi, 
dopo averlo dotato del riferi- 
mento all'oggetto si fa restituire 
la dimensione dell'intestazio- 
ne, ovvero i byte spesi per me- 
morizzare la dimensione del 
blocco dati. Con i controlli del 
caso, alloca il buffer necessario 
e legge l'intestazione dal file, 
quindi alloca il buffer per i dati 
e li legge dal file e, dopo la flip, 




FILEFILTER 

FileFilter è definita in 
due pacchetti: ja vax- 
.swing.filechooser e 
java.io. La prima è di- 
scussa nell'articolo ed 
ad uso esclusivo delle 
JFileChooser, la secon- 
da è un'interfaccia che 
richiede l'implementa- 
zione del metodo 
accept (File pattinarne); 
metodo che restituisce 
un booleano. Per usar- 
lo si pone l'indirizzo di 
una cartella in un og- 
getto File a cui si appli- 
ca il metodo listFiles 
che prende il filtro co- 
me parametro. Il meto- 
do restituisce l'array 
fi/e/7 dei file che si 
trovano nella cartella e 
verificano le condizioni 
imposte. 




Fig. 5: Struttura del package fileFormat e rela- 
zioni coi package delI'SDK 1.4. 



chiede ad jff di estrarre la sua parte di informazione. 
Conclusa l'operazione ordina all'oggetto di riorga- 
nizzare i dati letti. I metodi sane e open di Action- 
Handler saranno dunque di questo tipo: 
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RIFLESSIONE 

I metodi di riflessione 

permettono di 

accedere a campi e 

metodi di una classe, 

pubblici, privati o 

protetti; la chiave del 

meccanismo risiede 

nella classe Class e nel 

fatto che, per 

assicurare il 

polimorfismo, il 

linguaggio tiene 

traccia dei metodi e 

degli attributi di 

ciascuna classe 

utilizzata. A questo 

punto è sufficiente un 

riferimento alla 

particolare istanza 

dell'oggetto per 

violare le regole di 

incapsulamento ed 

ottenere risultati quali 

il meccanismo di 

serializzazione o il 

nostro package di 

gestione file. 



private void save(File output) 

{ try 

{ EFile nuovo=new EFileQ; 

if (Inuovo.openOutput(output)) { // messaggio 

d'errore // } 
nuovo. put(gestoreFormato); 
nuovo. put(finestra. foglio); 

if (! nuovo. closeOutput()) // messaggio d'errore // } 
catch (FileExceptions fé) { // messaggio d'errore // } 
catch (Exception e) { // messaggio d'errore // } } 
private boolean open(File input) 

{ try 

{ EFile nuovo=new EFileQ; 

return true; 



L'oggetto gestoreFormato è di tipo ProgramFormat- 
Handler, una classe bufferizzabile definita nel no- 
stro pacchetto file per gestire i dati sulle versioni dei 
programmi scriventi e le compatibilità con le ver- 
sioni precedenti. Il costruttore accetta tre parametri: 
versione e revisione dello scrivente e versione com- 
patibile (vedi box). Nel nostro esempio abbiamo 
due possibilità: 

1} autorizziamo la lettura dei file 'nuovi' anche con 
la vecchia versione: la vecchia versione, quella 
che non esiste, interpreterebbe i punti di con- 
trollo come punti normali; 

2) vietiamo la lettura alla vecchia versione: l'istru- 
zione gestoreFormato.isCompatibleO; restituireb 
be false per indicare l'incompatibilità di versione. 



OGGETTI 
"BUFFERIZZABILI" 

Vediamo qualche implementazione dei metodi pre- 
visti dall'interfaccia Bufferizzable. Allo scopo distin- 
guiamo due casi: 

1) l'oggetto è una classe bufferizzabile di base: un 
caso significativo è quello di Patii. 

private int colorelntero, bordolntero, sfondolntero; 

private char caratteristiche; 

private Point2d[] vettorePunti; 

private static String[] attributiDaScrivere={ 

"colorelntero", "bordolntero", "sfondolntero", 
"caratteristiche", "vettorePunti"}; 
private static FileFormatData datiFormato=new 
FileFormatData(attributiDaScrivere, FileFormatData .INT) ; 
public FileFormatData getFileFormatData() 
{ return datiFormato; } 
public void afterFileReading() 
{ colore=new Color(colorelntero); 



modificato=true; } 
public void beforeFileWritingO 
{ coloreIntero=colore.getRGB(); 

bordoIntero= bordo. getRGB(); 

sfondoIntero=sfondo.getRGB(); 

caratteristiche=(chiuso)?'c':'a'; 

vettorePunti = punti.toArray(); } 

Notiamo che fra gli attributi dichiarati abbiamo 
attributiDaScrivere che è un vettore di stringhe sta- 
tico contenente i nomi degli attributi da leggere/ 
scrivere ed un FileFormatData, anch'esso statico 
poiché i dati di formato saranno sempre quelli ed 
anche il tipo di variabile numerica usata come inte- 
stazione. I metodi più significativi sono afterFile- 
Readinge beforeFileWriting in cui si può vedere co- 
me i dati debbano essere riorganizzati. La ragione è 
semplice: né gli oggetti Color né gli oggetti Vector 
possono essere letti/ scritti 'direttamente' su file, non 
essendo bufferizzabili. Inoltre ed il nostro Format- 
Handler è in grado di gestire solo oggetti bufferiza- 
bili, tipi fondamentali non booleani ed array, anche 
multidimensionali, di oggetti bufferizzabili o di tipi 
fondamentali non booleani. 

2) l'oggetto estende una classe bufferizzabile, è il 
caso della nostra Point2d: 

protected char caratteristiche='\0"; 

private static String[] attributiDaAggiungere={ 

"caratteristiche"}; 
public FileFormatData getFileFormatData() 

{ int i = (caratteristiche= = '\Q')?0:l; 

return new FileFormatData(atthbutiDaAggiungere, 

i, super.getFileFormatDataO); } 
public void afterFileReading() 
{ controllo=(caratteristiche= = 'c'); } 
public void beforeFileWriting(){} 

Qui i dati sono opzionali, quindi devono essere let- 
ti/scritti col metodo e con i controlli del caso, ed es- 
sendo da aggiungere ai dati della superclasse nella 
getFileFormatData costruiremo 'al volo' un FileFor- 
matData che fornisca l'elenco dei dati opzionali, il 
numero di questi che dovranno essere scritti nel 
caso di una scrittura su file ed un riferimento al 
FileFormatData fornito dalla superclasse. 



IL GESTORE 
DI FORMATO 

Arriviamo al cuore del package: iniziamo con uno 
sguardo a FileFormat. Subito dopo spenderemo 
qualche parola attorno all'implementazione di For- 
matHandler. Non ci occuperemo di OptionalData 
data la sua semplicità. Per cominciare, FileFormat 
dichiara un Vector detto estensioni che raccoglierà 
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gli eventuali OptìonalData. 

private Vector estensioni = null; 

Il costruttore scandisce fileFormatData creando 
tanti oggetti OptìonalData quante sono le estensio- 
ni opzionali del formato, la prima estensione che 
dichiara almeno un attributo in scrittura forza le 
successive alla scrittura di tutti i loro attributi. La 
scansione finisce con l'individuazione del FileFor- 
matData restituito dall'oggetto Bufferizzable base. I 
dati di questo definiscono il FileFormat. Il metodo 
setReference scandisce estensioni risalendo la cate- 
na di derivazione delle classi. A ciascuna estensione 
viene associato l'oggetto e la particolare classe nella 
catena di derivazione. 

public void setReference(Object object) throws 

FileFormatException 
{ reference(object); 
Class c=object.getClass(); 
int tot=(estensioni = = null)?0: estensioni. size(); 

for (int i=tot; — i> = 0;) 

{ FormatHandler fh = (FormatHandler) 

estensioni. elementAt(i); 
fh.reference(object); 
fh.classeOggetto=c; 
c=c.getSuperclass(); } 
if (c= = null) // gestione errore // 
classeOggetto=c; } 

Il metodo onBufferSize restituisce la dimensione del 
blocco dati e dell'intestazione relativa all'oggetto a 
cui si riferisce il FileFormat in questione. Allo scopo 
si scandisce estensioni, sommando la dimensione 
dei dati di ciascuna a quella dei dati dell'oggetto 
Bufferizzable fondamentale. Il metodo toBuffer ese- 
gue il trasferimento dei dati sul buffer incomincian- 
do con l'intestazione, quindi con i dati propri, quel- 
li essenziali, ed infine con i dati opzionali. 

public boolean toBuffer(ByteBuffer b) throws FileExceptions 
{ if (b.remaining()<dimBlocco) return false; 
switch (intestazione) 

{ case BYTE: b.put((byte)(dimBlocco-intestazione)); 

break; 
case SHORT: b.putShort((short)( 

dimBlocco-intestazione)); break; 
case INT: b.putlnt(dimBlocco-intestazione); break; 
default: // gestione errore // } 

dataToBuffer(b); 

if (estensioni = = null) return true; 

Iterator i= estensioni. iteratorQ; 

while (i.hasNext()) 

{ OptìonalData o=(OptionalData)i.next(); 

o.dataToBuffer(b); } 

return true; 
} 



Infine, il metodo byBuffer, esegue la lettura dei dati 
dal buffer incominciando con i dati propri, quelli 
essenziali, per finire con i dati opzionali. 

public boolean byBuffer(ByteBuffer b) throws Exception 

{ dataByBuffer(b); 

if (estensioni= = null) return true; 
Iterator i=estensioni.iterator(); 
while (i.hasNext() && b.hasRemainingO) 
{ OptìonalData o=(OptionalData)i.next(); 

o.setDataAmount(OptionalData.REQUIRED); 

o.dataByBuffer(b); } 

return true; } 

Riguardo FormatHand- 
ler diciamo subito che 
realizza i suoi metodi ri- 
correndo a metodi di ri- 
flessione. Tali meccani- 
smi sono estremamente 
delicati poiché permet- 
tono di violare l'incapsu- 
lamento e, dato che que- 
sta strategia contravvie- 
ne alla logica di Java, non 
approfondiremo l'argo- 
mento. La logica dei me- 
todi fondamentali, data- 
ToBuffer, dataByBuffer e 
dataSize, è quella di recuperare l'accesso agli attri- 
buti dell'oggetto utilizzando il loro nome. Recupe- 
rato l'accesso è possibile sapere se l'attributo sia un 
tipo fondamentale, un array o un Bufferizzable ed 
agire di conseguenza. Ad esempio, se l'attributo è 
un tipo fondamentale, si usa il metodo primitive- 
ToBuffer per la scrittura: 

private boolean primitiveToBuffer(Object field, Class fieldClass) 
{ ...} 

in cui utilizziamo i metodi put del ByteBuffer, ed il 
metodo primitiveByBuffer per la lettura: 

private boolean primitiveByBuffer(Field field, Object 

object, Class fieldClass) 
{...} 

nel quale utilizziamo i metodi get del ByteBuffer. 

CONCLUSIONI 

Con questo è tutto. Ulteriori sviluppi sarebbero pos- 
sibili: ad esempio aggiungere il supporto per i for- 
mati immagine standard (a riguardo rimando al tip 
apparso sul numero 80 della rivista) ma lo spazio è 
tiranno. Quindi vi lascio con la speranza che Raffae- 
llo possa divertirvi ed essere spunto per nuove idee. 

Stefano Russo 





Fig. 6: Se il nome di un campo è errato si ottiene 
un'eccezione al momento dell'accesso. Il package 
exceptions non sarà discusso. 



SERIALIZZAZIONE 

La serializzazione è un 
meccanismo, previsto 
dal linguaggio, di tra- 
sformazione di un og- 
getto e dei suoi attri- 
buti in una serie di by- 
te e viceversa. Lo stru- 
mento è potente ma 
non risponde alle no- 
stre necessità: i dati di 
formato, ad esempio, 
contemplano il nome 
della classe ed altre in- 
formazioni specifiche 
relative all'oggetto se- 
rializzato allo scopo di 
ricostruirlo tale e quale 
in lettura. Questo crea 
problemi di compatibi- 
lità qualora successive 
versioni del program- 
ma utilizzassero oppor- 
tune estensioni degli 
oggetti già esistenti. 
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Applicazioni fisico-matematiche e di grafica 3P 

Un motore di 
simulazioni fisiche 

parte seconda 

Consta di diverse componenti relazionate secondo una derivazione 
gerarchica. Le basi, i sistemi di coordinate e i corpi rigidi sono 
le classi per raggiungere l'obiettivo. 



Dopo aver percorso i primi passi verso la rea- 
lizzazione di un motore di simulazioni fìsi- 
che, attraverso l'implementazione di oppor- 
tune classi di base per la manipolazione dei dati tipi- 
ci dei fenomeni fisici, è arrivato il momento di fare 
un ulteriore cammino che porti alla definizione di 
una classe in grado di esprimere, da un punto di 
vista matematico, in modo completo, un corpo rigi- 
do. Ricordo, che la volta scorsa abbiamo già svilup- 
pato due importanti oggetti VECTOR e MATRIX 
(questo ultimo da non confondere con il soggetto 
dei fratelli Wathoski!) con i quali abbiamo assolto il 
compito di base riferito all'analisi vettoriale, passag- 
gio fondamentale e punto di riferimento per qual- 
siasi fenomeno si voglia descrivere in uno spazio 3D. 
Si tratta adesso sulla base dei metodi sviluppati di 
costruire nuove classi che consentano la produzione 
di un oggetto finale corpo rigido. Come vedremo, il 
passaggio non è immediato, anche se il percorso è 
rettilineo e non prevede particolari difficoltà se non 
qualcuna di ordine teorico che tenterò di non far ap- 
parire con opportuni chiarimenti, ma che comun- 
que è facilmente colmabile dalla consultazione di 
un qualsiasi testo sulle nozioni di base della geome- 
tria lineare. Non lasciamoci ingannare dal titolo, i 
nuovi oggetti saranno anche gli ultimi (certo chi 
avesse voglia e tempo per farlo potrebbe, a partire 
dal materiale prodotto e che produrremo, sviluppa- 
re altri interessanti componenti). La piattaforma che 
si sta creando essendo ben strutturata e ricca di con- 
tenuti è un ideale punto di partenza per ulteriori svi- 
luppi. Per concludere questa premessa vorrei ribadi- 
re come il programmatore ad oggetti non troverà 
alcuna difficoltà nella lettura di questo articolo pro- 
prio per la natura del progetto. Non sarà necessario 
ai fini della comprensione della presente trattazione 
conoscere i metodi matematici per la manipolazio- 
ne di vettori e matrici, basterà sapere che essi esisto- 



no e che si possono modificare mediante operazio- 
ni come prodotto vettoriale, la normalizzazione e 
quanto altro, senza peraltro avere il cruccio di cono- 
scere il metodo usato per realizzare tali operazioni. 
Certo, per una completa e profonda conoscenza del- 
l'argomento si auspica la presa visione di tali fasi 
dello sviluppo del progetto, ma come ripeto, ciò non 
è richiesto per la piena comprensione della seconda 
parte che ci apprestiamo a sviluppare. 



UNA BREVE 
INTRODUZIONE 

Le cosa importante da ricordare è che ci muoviamo 
in uno spazio a tre dimensioni tipico dei giochi 3D. 
È in questo ambito che intendiamo costruire dei 
modelli matematici successivamente implementa- 
bili come classi per lo sviluppo di un motore di si- 
mulazioni fisiche. Il linguaggio di programmazione 
usato è il C++ per la sua naturale propensione alla 
OOP, in particolare di tale linguaggio si apprezzano 
le caratteristiche proprie dell'ereditarietà e soprat- 
tutto il potente overloading che è possibile attuare. 
Mediante quest'ultimo, dopo aver superato il non 
banale ostacolo iniziale di progettazione e sviluppo 
di funzioni che prevedano la sovrapposizione di 
operatori come ad esempio la somma tra matrici, 
l'implementazione diventa del tutto naturale e può 
essere facilmente realizzata, come se scrivessimo ti- 
piche espressioni di algebra lineare per la manipola- 
zione di vettori e matrici, anche con le stesse nota- 
zioni. Ma cosa dobbiamo fare adesso? Sviluppare in- 
nanzitutto una classe di base {BASIS) in grado di de- 
scrivere un sistema orientato, e lo faremo definendo 
un sistema ortonormale. A tale classe assoceremo 
importanti metodi per la rotazione e la traslazione. 
Da essa potremo derivare un altro importante og- 
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getto che definisce uno o più sistemi di assi cartesia- 
ni (COORD_FRAME), il che consente la descrizione 
di fenomeni su corpi in movimento. Si pensi alle 
dinamiche che possono avvenire all'interno di un 
treno in viaggio, è chiaro che prenderemo come rife- 
rimento lo scomparto dove ci troviamo, se si vuole 
conoscere il movimento di un oggetto è necessario 
tenere conto del fatto che il treno non è fermo. In- 
fine, produrremo il corpo rigido (RIGID_BODY). Le 
varie classi sono relazionate da una catena di deri- 
vazione gerarchica riportata in Fig. 1. 



BASIS 


i COORD_FRAME 










RIGID_BODY_STATE 












RIGID_BODY 









Fig. 1: Struttura ad oggetti del progetto, secondo le regole di derivazione. 



TIPI BASE 

Un vettore orientato può essere memorizzato in più 
modi. Una prima soluzione prevede l'individuazio- 
ne di una quaterna di numeri. Così facendo è suffi- 
ciente memorizzare quattro scalari, le operazioni 
(da quelle semplici come la somma e la differenza, 
alla rappresentazione grafica) in questo contesto 
richiederanno un'efficiente interpolazione. Una se- 
conda soluzione fa uso di una base ortonormale, ov- 
vero, tre vettori unità mutuamente ortogonali, de- 
scritti da una matrice di dimensione 3 x 3. In tal caso 
si usano ben nove scalari e l'interpolazione risulta 
meno efficiente, ciononostante è una soluzione ap- 
petibile; infatti, sarà la strada che intraprenderemo, 
poiché è facile la trasformazione da e per un altro 
sistema di assi cartesiani (manovra di uso comune 
sia nelle simulazioni fisiche che nei giochi 3D). Ci si 
potrebbe chiedere come mai vi è la necessità di de- 
finire una classe come base di rappresentazione di 
un vettore quando, come descritto, è sufficiente una 
matrice di dimensione 3 x 3. La risposta è indiretta- 
mente data dal rispetto delle norme della OOP che 
impongono una chiarezza semantica tra vari oggetti 
che hanno scopi diversi. Del resto, mentre per un 
vettore orientato sono richieste operazioni come la 
rotazione e la traslazione, per una matrice si hanno 
calcoli matematici di base come la somma e il pro- 
dotto. 

// Base ortonormale 
class BASIS 



{ public: 

MATRIX R; 

public: 

BASISQ 

{} 

// Costruttore come tre vettori giustapposti 
BASIS(const VECTOR& vO, 

const VECTOR& vl,const VECTOR& v2) 

// Implementato come matrice R (elemento MATRIX) 
: R( vO, vi, v2 ) 

{} 

// Costruttore direttamente come matrice 

BASIS( const MATRIX& m ) 

: R(m ) 

{} 

// Operatori di overloading 

const VECTOR& operator [] ( long i ) const { 

return R.C[i]; } 

const VECTOR& x() const { return R.C[0]; } 

const VECTOR& y() const { return R.C[1]; } 

const VECTOR& z() const { return R.C[2]; } 

const MATRIX& basisQ const { return R; } 

void basis( const VECTOR& vO, const VECTOR& vi, 

const VECTOR& v2 ) 

{this->R[0] = vO; 

this->R[l] = vi; 

this->R[2] = v2; } 

// Rotazioni con la regola della mano destra 

void rotateAboutX( const SCALAR& a ) 

{ 

if( != a ) // Non ruota se zero 

_J 

VECTOR bl = this->Y()*cos(a) + this->Z()*sin(a); 
VECTOR b2 = -this->YQ*sin(a) + this->Z()*cos(a); 
//cambio di base 

this->M[l] = bl; 

this->M[2] = b2; 

//x non cambia } 

} 

void rotateAboutY( const SCALAR& a ) 

{ 

if( != a ) // Non ruota se zero 

A 

VECTOR b2 = this->Z()*cos(a) + this->X()*sin(a); 

//ruota z 
VECTOR bO = -this->Z()*sin(a) + this->X()*cos(a); 

//ruota x 
//cambio di base 

this->M[2] = b2; 

this->M[0] = bO; 

//y non cambia } 

} 

void rotateAboutZ( const SCALAR& a ) 

{ if( ! = a ) // Non ruota se zero 

{ VECTOR bO = this->X()*cos(a) + this->Y()*sin(a); 

//ruota x 
VECTOR bl = -this->X()*sin(a) + this->Y()*cos(a); 

//ruota y 
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//cambio di base 

this->M[0] = bO; 

this->M[l] = bl; 

//z non cambia } 

} 

//rotazione delle basi intorno l'unita di componente u 

dell'angolo theta (radianti) 
void rotate( const SCALAR& theta, const VECTOR& u ); 
//rotazione di lunghezza da e angolo theta, 

nella direzione di u 

void rotate( const VECTOR& da ); 

// Trasformazioni 

const VECTOR transformVectorToLocal( const 

VECTOR& v ) const 

{ return VECTOR( R.C[0].dot(v), R.C[l].dot(v), 

R.C[2].dot(v) ); } 

const POINT transformvectorToParent( const 

VECTOR& v ) const 

{ return R.C[0] * v.x + R.C[1] * v.y + R.C[2] * v.z; } 

}; 

Come ci aspettavamo, la classe appena sviluppata a 
partire da informazioni proposte come matrici 3x3 
o comunque come tre vettori di dimensione tre giu- 
stapposti, effettua le operazioni tipiche di rotazione 
e traslazione. Si possono notare le rotazioni intorno 
ad un qualsiasi asse nella loro completezza anche 
come codice. Esse sono sviluppate facendo uso delle 
note matrici di rotazione, nel caso particolare pa- 
rametro a indica l'angolo di rotazione in radianti. 
Facilmente si possono realizzare le altre due rotazio- 
ni sotto forma di prototipi. Le trasformazioni realiz- 
zano le funzioni descritte nel box. 



SISTEMI 

DI COORDINATE 

Così come la terna di valori (x,y,z) di un vettore di- 
pende dalla base che si sta usando; la terna (x,y,z) di 
un punto nello spazio a tre dimensioni dipende dal 
sistema di coordinate usato. Ad esempio, la punta 
della matita che adesso vedo sulla mia scrivania as- 
sume coordinate diverse a seconda se il sistema di 
riferimento è appunto la scrivania, la stanza, l'edifi- 
cio, il centro della terra o quanto altro. Sostanzial- 
mente ad una base bisogna associare un'origine. Si 
deve poter passare da un riferimento ad un altro. 
Rispetto alla struttura ereditaria di Fig. 1 implemen- 
tiamo la classe COORD FRAME 



Il Sistema di coordinate (base and origine) 


class COORD_FRAME 


: public BASIS 




{ public: 


POINT 0; //origine del sistema di coordinate, re 


lative al 


//riferimento padre (da 


non confondere la con 


lo zero) 


public: 


// Costruttore vuoto 



COORD_FRAME() 

O 

// Costruttore con tre vettori e l'origine 
COORD_FRAME(const POINT& o, const VECTOR& vO, 
const VECTOR& vl,const VECTOR& v2) 

: ( o ), 

BASIS ( vO, vi, v2 ) 

{} 

COORD_FRAME(const POINT& o, const BASIS& b) 

: ( o ), 

BASIS ( b ) 

{} 

const POINT& position() const { return O; } 

void position( const POINT& p ) { O = p; } 

const POINT transformPointToLocal( const POINT& p ) 

const 

{ //trasla all'origine del sistema di coordinata, si 

proietta nella base 
return transformvectorToLocal( p - ); } 
const POINT transformPointToParent( const P0INT& p ) 

const 
{ //Trasforma le coordinate vettore e le trasla 

rispetto all'origine 
return transformVectorToParent( p ) + 0; } 
//Trasla l'origine rispetto a un vettore dato 

void translate( const VECTOR& v ) 

{0+= v; }}; 

Il metodo position restituisce la posizione. Gli altri si 
occupano di traslare e trasformare vettori rispetto 
all'origine. Le varie routine sono opportunamente 
commentate. 



CORPI RIGIDI 

L'ultimo passo è quello di produrre un oggetto corpo 
rigido, sulla base delle rigorose scelte fatte. Per chia- 
rezza è opportuno scomporre ulteriormente in due 
classi RIGID_BODY_STATE che tiene traccia delle 
variazioni dinamiche del corpo. Viene derivato da 
COORD_FRAME e include la velocità lineare, la velo- 
cità angolare, il tensore di inerzia e il suo inverso. 
Passiamo al codice. 

// Descrive lo stato dinamico del corpo rigido 
class RIGID_BODY_STATE : public COORD_FRAME 
{ public: 

VECTOR V; //velocità lineare, metri/sec 
VECTOR W; //velocità angolare, radianti/sec 
MATRIX I; //tensore di inerzia con riferimento allo 

spazio terrestre, kg m m 
MATRIX IJnv; //inversa del tensore di inerzia 
public: 
RIGID_BODY_STATE() 

O 

RIGID_BODY_STATE(const VECTOR& v, const VECTOR& w) 
: V (v). 
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W (w) 

{} 

const VECTOR& velocityQ const { return V; } 

void velocity( const VECTOR& v ) { V = v; } 

const VECTOR& angularVelocity() const { return W; } 
void angularVelocity(const VECTOR& v) {W = v;} 
const MATRIX& inertiaTensor() const { return I; } 
const MATRIX& inverseInertiaTensor() const { 

return Ljnv; } 
//Calcola il tensore di inerzia e il suo inverso 
//dal corrente vettore e il principale momento di inerzia 
void calculateInertiaTensor( const VECTOR& ip ); 

}; 




TRASFORMAZIONI 

Per trasformare un vettore v dal suo spazio di riferimento [body) allo 
spazio terrestre moltiplichiamo le tre componenti x, y e z di v per i 
corrispondenti assi e addizioniamo tutti i risultati, come scritto di seguito: 

VECTOR v_world = v.x* X_body + v.y*Y_body+v.z*Z_body 

Per fare la trasformazione inversa dallo spazio terrestre a quello di 
riferimento del corpo, per ogni componente del corpo si deve fare il 
prodotto scalare tra il vettore e il riferimento; ecco come con riferimento 
ai metodi di VECTOR. 

vjìody.x = v.dot(X body) 
vjìody.y = v.dot(Y_body) 
v_body.z = v.dot(Z_body) 



Per finire possiamo scoprire sipario sull'oggetto ul- 
timo anello della catena di derivazione. Oltre alla ro- 
tazione, traslazione, trasformazione, posizionamen- 
to, accelerazione lineare e angolare, per il corpo rigi- 
do possiamo rilevare le collisioni. Inoltre, abbiamo a 
disposizione uno stato precedente, utile nelle dina- 
miche di movimento di un corpo. 



// Descrive un corpo rigido 


class RIGID_BODY : public RIGID 


_BODY_STATE 




{ public: 


//stato dinamico precedente 


RIGID_BODY_STATE PrevState; 


//massa e inerzia rotazionale 


SCALAR M; //mass, kg 


VECTOR Ip; //principali momenti of inerzia, kg m m 


public: 


RIGID_BODY() 


: M(l), Ip(l,l,l) 


{} 


RIGID_BODY( const SCALAR& m, 


const VECTOR& ip 


) 


: M(m), Ip(ip) 


{} 


void mass( const SCALAR& m ) { 


M = m; } 




SCALAR mass() const { return M; 


} 




void inertiaMoments( const VECTOR& ip ) { Ip = ip; 


} 


const VECTOR& inertiaMoments() const { return Ip; 


} 


}; 



Ecco un esempio di codice C++ mediante il quale si 
simula il movimento di un corpo rigido sotto la forza 
e la torsione (sulla base delle equazioni di Newton 
ed Eulero). Come si può notare di seguito la stessa 
cosa in C è meno elegante. Ecco un'altra occasione 
per apprezzare la OOE 

// Soluzione C+ + 

void RIGID_BODY::move( const SCALAR dt ) { 

VECTOR F, T; 

this->Translate( this->V * dt ); 

this->Rotate( this->W * dt ); 

ComputeForceAndTorque( F, T ); 

this->V += (l/this->M)* F * dt; 

this->W += this->I_inv * (T - W.cross(I*W)) * dt; 

} 

// Codice equivalente C 

void RIGID_BODY_Move( RIGID_BODY* pBody, 

SCALAR dt ) 

{ 

VECTOR F, T, t, v; 

pBody->State.Frame.Q.x += pBody->State.V.x * dt; 
pBody->State.Frame.Q.y += pBody->State.V.y * dt; 
pBody->State.Frame.Q.z += pBody->State.V.z * dt; 
vmul( t, pBody->State.W, dt );//macro 
RotateBasis( pBody->State.Frame.Basis, &t ); 
ComputeForceAndTorque( &F, &T ); 

s = 1/ pBody->M; 

pBody->State.V.x += s * F.x * dt; 

pBody->State.V.y += s * F.y * dt; 

pBody->State.V.z += s * F.z * dt; 

matrix_mul( t, pBody->State.I, pBody->State.W ); 

//t = I*W 

vcross( v, pBody->State.W, t ); //v = Wx(I*W) 

vsub( t, T, v ); //t = T - Wx(I*W) 

matrix_mul( v, pBody->State.I_inv, t ); //v = Mnv*( 

T - Wx(I*W)) 

vmul( t, v, dt ); //t = I_inv * (T - Wx(I*W)) * dt 

pBody->State.W.x += t.x; 

pBody->State.W.y += t.y; 

pBody->State.W.z += t.z; 

} 



CONCLUSIONI 

Abbiamo visto come un buon insieme di dati struttu- 
rati associa ad un corretto e chiaro progetto OOP 
garantisca risultati di semplice comprensione ed ef- 
ficienti. Si tratta solo di riservare inizialmente un po' di 
tempo alla progettazione. 

Concludo questa esperienza soddisfatto di aver 
costruito del codice semplice ed efficiente, e sperando 
che possa essere da spunto per chi ha intenzione di 
sviluppare in tale ambito. 

Nel ricercare nuovi ed interessanti argomenti, porgo 
un saluto a tutti i lettori. 

Fabio Grimaldi 
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Quesiti elementari dai sorprendenti spunti algoritmici 

Ritorno al classico 

Le torri di Hanoi è un classico rompicapo che ha appassionato gli amanti 
del genere per molti anni. L'avvento del computer ha dato alla questione 
nuova linfa e tuttora è riconosciuto come uno dei più interessanti esercizi. 



Tra un rompicapo e l'altro di tanto in tanto 
spuntano problemi classici che manten- 
gono intatto il loro fascino e la forte valen- 
za didattica. È il caso delle torri di Hanoi che 
oltre ad essere un gradevolissimo gioco da fare 
anche disconoscendo l'esistenza del mostro al 
silicio, ha importanti riferimenti alle soluzioni 
di algoritmi ricorsivi. Senza entrare nei partico- 
lari della risoluzione che lasciamo di consueto 
al lettore, si sappia che quello delle torri di Ha- 
noi è senza dubbio l'esempio più fulgido che 
viene proposto per esplicare la ricorsione. Ma 
facciamo un passo indietro. I lettori dello scorso 
appuntamento reclamano attenzione. 
Abbiamo, infatti seminato, nel terreno della 
nostra capacità risolutiva, due nuovi problemi, 
per la verità non molto difficoltosi ma dagli 
spunti intriganti. 

Affronteremo nei prossimi due paragrafi la riso- 
luzione ai problemi proposti, ossia il gioco di 
Euclide e il trucco magico di Bechelet. Per ter- 
minare, formuleremo l'enigma delle citate torri 
di Hanoi. 



IL GIOCO DI EUCLIDE 

Il gioco proposto è, nella sua formulazione, ba- 
nale, ma come vedremo propone utili spunti di 
riflessione nella fase di soluzione. Dopo aver 
sorteggiato due numeri bisogna a turno scrivere 
su un foglio un numero che sia la differenza di 
due presenti. Ovviamente, al primo passo ci sa- 
rà una sola possibilità che è la differenza dei due 
numeri iniziali. Perde chi non ha più alcun nu- 
mero da scrivere. La cosa sorprendente è che si 
può stabilire subito quanti siano i numeri che si 
possono produrre con la sola conoscenza del 
massimo comun divisore (mcd) tra i due. 
Avremo quindi la possibilità di rivisitare l'algo- 
ritmo per il calcolo del mcd proposto da Eucli- 
de, un altro classico! 

Si parte dalla considerazione che la differenza 
tra due qualsiasi numeri è divisibile per mcd 
degli stessi. Supponendo che i due numeri N e 
M siano tali che N>M (trascurando il caso limite 
in cui siano uguali) allora i soli numeri che si 
possono ottenere per differenza, così come for- 



mulato il gioco, sono multipli di mcd(N,M) 
(massimo comun divisore di N e M). Si faccia 
qualche esempio a riprova di quanto scritto. 
Cosicché è possibile individuare il numero di 
interi che si possono scrivere, essi sono pari a 
N/mcd(N,M), compresi in tale quantità anche gli 
iniziali N e M. La conoscenza del numero di 
mosse che porta all'esaurimento del gioco è 
un'informazione fondamentale per l'esito finale 
del gioco. Così se l'avversario non sa il trucco, 
potremo scegliere se iniziare per primi o meno a 
seconda che il numero di mosse sia dispari o 
pari, all'ovvio fine di vincere la partita. 
Facciamo qualche esempio. Se i due numeri so- 
no 10 e 6, allora mcd(10,6) è 2 da cui deduciamo 
il numero di mosse (10/2=5) pari a cinque. Es- 
sendo dispari vinceremo se avremo a disposi- 
zione la prima mossa. Un altro esempio: siano i 
due numeri 36 e 9 il mcd(36,9) = 9 da cui si 
deduce N/mcd(N,M) pari a 36/9=4. Questa volta 
per vincere la partita, il numero pari ci impone 
di cominciare per secondi. 
Riesaminiamo con piacere l'algoritmo di Eucli- 
de per l'individuazione del massimo comun di- 
visore tra due numeri. Solitamente è tra i primi 
che si apprendono quando si affronta la pro- 
grammazione e la costruzione di algoritmi. Sia- 
no a e b due numeri di cui si vuole calcolare 
mcd(a,b), supposto che a>b, il metodo è basato 
su due considerazioni. La prima indica che se b 
è divisibile per a allora, ovviamente, mdc(a,b) 
=b, ricordando che il più grande divisore di un 
qualsiasi numero è se stesso. Esempio, mcd( 
14,7)=7. Si rammenta, inoltre, che l'insieme di 
riferimento sono i numeri naturali, non si tiene 
conto quindi, di numeri negativi. 
La seconda considerazione che esprime la vera 
natura dell'algoritmo è basata sull'espressione 
a = b*t + r, con ter numeri naturali (interi non 
negativi). Se tale espressione è valida allora 
mcd(a,b) = mcd (b,r). Infatti ogni comune divi- 
sore di a e b è anche divisore di r. Così mcd(a,b) 
divide r. 

Ma naturalmente mcd(a,b) e divisibile per b. 
Perciò mcd(a,b) è divisibile per b quanto per r, 
dunque mcd (a,b) <= mcd (b,r). L'inverso è an- 
che vero poiché ogni divisore di b e r lo è anche 
di a. Ecco un esempio. 
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Sia a = 2322, b = 654. 




SOLUZIONI 



RICORSIOIME 

Un definizione è ricor- 
siva se è descritta me- 
diante se stessa. I nu- 
meri naturali o la po- 
tenza di un numero 
possono essere spie- 
gati matematicamente 
in modo ricorsivo. 
Vediamo come. L'in- 
sieme dei numeri 
naturali è definito 
secondo le seguenti 
due regole: 

1) 1 è un numero 

naturale 

2) Il successore di un 

numero naturale è 

ancora un numero 

naturale. 

Da questa definizione 
per il primo punto 
risulta che il numero 1 
è un numero naturale. 
La seconda regola 
applicata la prima 
volta indica che il 
numero 2 è un nume- 
ro naturale visto che è 
il successore di un 
altro numero naturale, 
ovvero, 1. Applicando 
nuovamente la secon- 
da regola ci si rende 
conto che anche il 
numero 3 appartiene 
all'insieme dei numeri 
naturali. Continuando 
ad applicare un nume- 
ro infinito di volte tale 
regola si nota che i 
numeri 4,5,6,7, .. 
appartengono tutti ai 
numeri naturali. 
L'insieme è costituito 
da infiniti elementi. 



2322 = 654*3 + 360 


mcd(2322, 654) = mcd(654, 360) 


654 = 360*1 + 294 


mcd(654, 360) = mcd(360, 294) 


360 = 294*1+66 


mcd(360, 294) = mcd(294, 66) 


294 = 66*4 + 30 


mcd(294, 66) = mcd(66, 30) 


66 = 30*2 + 6 


mcd(66, 30) = mcd(30, 6) 


30 = 6*5 


mcd(30, 6) = 6 



perciò gcd(2322,654)=6 

IL TRUCCO MAGICO 
DI BECHELET 

Esaminiamo il secondo enigma proposto nello 
scorso appuntamento. Dopo aver scelto una cop- 
pia di numeri tra N*(N+l)/2, si devono indovinare 
gli stessi presentati singolarmente in forma di 
matrice e con la sola indicazione della loro collo- 
cazione come riga all'interno della matrice (di- 
mensione Nx (N+l)). Il calcolo combinatorio, che 
anche in passato ci ha spesso aiutato, risulterà 
prezioso in questa occasione. La formulazione da 
adottare per la ricerca della soluzione prevede il 
minor numero di oggetti che si possono combina- 
re in tutti i modi possibili. Se N=4 abbiamo 
N*(N+l)/2 combinazioni, ecco quali: {1, lì, 11, 2], 

11, 3j, {1, 4j, {2, 2j, {2, 3j, {2, 4], {3, 3], {3, 4} e {4,4}. Gli 
oggetti vengono presentati in forma matriciale 5 x 
4 (N+l) xN come mostrato di seguito: 

a, u, a, ih a, 21, a, 3}, a, 41, 

12, lf, {2, 2}, 12, 2}, {2, 3}, 12, 4}, 
{3, lj, {3, 2j, {3, 3}, {3, 3}, {3, 4j, 
(4, 1}, {4, 2}, {4, 3}, {4, 4}, {4, 4j, 

Si noterà che si tratta di una matrice speculare e 
anche se in ordine diverso le coppie di oggetti si 
presentano due volte. Nel caso di oggetti identici 
vi saranno semplicemente due volte le stesse cop- 
pie. Si distinguono quindi due triangoli uno infe- 
riore ed uno superiore in cui sono presenti tali 
coppie che definiremo simili. Ed è proprio questa 
duplicazione la chiave del trucco di Bechelet, poi- 
ché se ad ognuna delle 10 coppie di N elementi (4) 
viene associata una coppia di numeri da 1 a 20; 
esempio (1,2), (3,4), (5,6), (7,8), (9,10), (11,12), 
(13,14), (15,16), (1 7,18) e (19,20); si innesta la solu- 
zione al gioco. Ora, poiché ogni coppia nella ma- 
trice esaminata risulta due volte (anche se gli ele- 
menti sono proposti in ordine diverso), si potrà 
associare ogni numero ad un elemento della ma- 
trice. Operazione, questa ultima da svolgere con 
accortezza: se ad esempio si associa il numero 5 al 
paio jl, 3} ovviamente il suo accoppiato 6 corri- 
sponderà al reciproco { 3, 1}. 



Così, basta tenere traccia della corrispondenza 
numero-coppia per svelare il mistero. Infatti, se la 
coppia pensata è 5, 6, nel consultare la matrice si 
indicheranno le coppie 1 e 3 corrispondenti ai 
numeri 5 e 6. Ecco rilevato l'enigma. Per conclu- 
dere ricordo che i N*(N+1) numeri (nell'esempio 
20) possono essere prodotti casualmente, è neces- 
sario però fare l'associazione tra i numeri e le cop- 
pie della matrice di base. 



[ 



n 



1, 


2, 


3, 


5, 


7 


4, 


9, 


10, 


11, 


13 


6, 


12, 


15, 


16, 


17 


8, 


14, 


18, 


19, 


20 



Fig. 1: Posizione iniziale del gioco Torri dì Hanoi. 



TORRI DI HANOI 

È arrivato il momento di proporre un nuovo enig- 
ma. Come scrivevo si tratta di un problema classi- 
co. Si hanno ha disposizione tre paletti e n dischi 
di dimensioni diverse. Inizialmente i dischi sono 
impilati nel primo dei paletti in modo da formare 
una torre (il più grande alla base e sopra i dischi di 
dimensione sempre più piccoli, quello in cima sa- 
rà ovviamente il più piccolo). Si vogliono portare 
tutti i dischi dal paletto 1 al paletto 3 in modo che 
formino una torre come nel caso iniziale. Devono 
però essere rispettate le seguenti regole: 

1) ad ogni passo un solo disco viene spostato; 

2) un disco non può essere posto su un disco più 
piccolo; 

Il paletto 2 può essere utilizzato come sosta tem- 
poranea per i dischi. Premesso che la soluzione 
solo manuale, ossia senza l'uso del computer, è 
già molto interessante, è di notevole importanza 
la risoluzione algoritmica. Per questa hanno un 
aspetto fondamentale l'implementazione ricorsi- 
va e l'analisi delle tracce della variazione dello 
stack di sistema. 



CONCLUSIONI 

Rivolgere l'attenzione a problemi classici oltre che 
un utile esercizio di ripasso, è essenziale come 
atto di formazione rispetto ad alcune tipologie di 
problemi. E poi, non so voi, ma su di me, tali pro- 
blemi esercitano sempre un notevole fascino. Ad 
esempio, chi l'avrebbe detto che Euclide oltre ad 
essere un grande studioso era un giocherellone! 
La prossima volta, dopo questo ritorno al classico, 
questa piacevole parentesi, saranno di scena nuo- 
vi enigmi. Vi aspetto! 

Fabio Grimaldi 
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Python Italia 

Di linguaggi di programmazione ne esistono tanti. Alcuni, sono 
universalmente conosciuti ed applicati, altri, restano destinati ad una 
nicchia oppure circoscritti a particolari ambiti applicativi. 



G Python è il nome di un linguaggio rela- 
tivamente giovane, che da strumento 
di nicchia spinge sempre più per diven- 
tare un caposaldo dell'informatica moderna. Le 
carte in regola per il salto, in effetti, le ha tutte. 

COS'È PYTHON? 

Python è stato ideato ad Amsterdam da Guido 
Van Rossum [http://www.python.org/~gui- 
dol), a cavallo fra gli anni '80 e gli anni '90. Tecni- 
camente parlando Python è stato concepito 
come un linguaggio di scripting per ambienti 
UNIX, per estendere e semplificare la scrittura 
degli script destinati alla shell, più di quanto già 
non facesse Perl con la sua sintassi a tratti oscu- 
ra (da qualche parte ho letto, a proposito della 
sintassi di Perl, "stile passeggiata del micio sulla 
tastiera") . Python, rispetto ad altri linguaggi ana- 
loghi, è orientato agli oggetti, ed abbina alla sem- 
plicità di un linguaggio di scripting la completez- 
za e la potenza dei più tradizionali linguaggi di 
programmazione. 

E JAVA: COMPILATO 
O INTERPRETATO 

Python, proprio come Perl e Java, è sia interpre- 
tato sia compilato. Il compilatore di Python tra- 
duce il codice sorgente in una codifica interme- 
dia, un bytecode, che una macchina virtuale può 
poi interpretare ed eseguire con prestazioni 
migliori rispetto a quelle ottenibili con un lin- 
guaggio solamente interpretato. L'interprete di 
Python, necessario per eseguire qualsiasi codice 
scritto con questo linguaggio, rappresenta dun- 
que tale macchina virtuale. Come avviene con 
Perl, è possibile mandare in esecuzione un sor- 
gente Python, che l'ambiente del linguaggio tra- 
sformerà al volo in bytecode, prima dell'esecu- 
zione vera e propria. In maniera simile a Java, il 
bytecode ottenuto alla prima esecuzione del sor- 
gente viene conservato su disco, in modo che 
agli avvìi successivi non sia più necessaria la 
compilazione in linguaggio intermedio (salvo 
modifiche del sorgente, ovviamente, ed in que- 



®s$ìm 



Fig. 1: La homepage del Sito. 

sto Python ricorda anche la tecnologia JSP). 
Python, Perl e Java, dunque, hanno tutti e tre 
bisogno di un ambiente di esecuzione. Un'archi- 
tettura di questo tipo, è evidente, favorisce la 
portabilità del codice, purché la particolare piat- 
taforma hardware e software puntata disponga 
di un ambiente di esecuzione idoneo. Python, da 
questo punto di vista, è ben messo. Esistono 
interpreti per tutte le maggiori piattaforme in 
circolazione, e non solo: UNIX, Linux, Windows, 
Mac OS, Amiga, BeOS, OS/2 e così via. Inoltre, 
esiste una particolare implementazione dell'am- 
biente di Python, chiamata Jython e realizzata in 
Java. Jython compila un sorgente Python in byte- 
code Java, che può essere eseguito all'interno di 
qualsiasi macchina virtuale Java-compatibile. 
Laddove è disponibile Java è automaticamente 
disponibile anche Python. Riguardo l'attuale dif- 
fusione dell'interprete di Python, c'è da segnala- 
re che le principali distribuzioni Linux lo inclu- 
dono in maniera predefinita, giacché il linguag- 
gio si è ritagliato un'importante fetta applicativa 
in ambiente GNU /Linux. Gli utenti Windows, 
invece, possono tranquillamente scaricare ed 
installare per proprio conto l'ambiente, che ha 
un peso tutto sommato modesto. 



I PRO DI PYTHON 

Molti sono gli aspetti positivi di Python. 
Anzitutto è Software Libero. Poi è portabile, ed è 
anche efficiente, grazie al trucco della compila- 
zione in bytecode. Python ha una sintassi chiara. 
Croce e delizia del linguaggio è rappresentata 
dall'indentazione, che in Python assume signifi- 
cato rilevante ai fini della programmazione. 
L'indentazione, in altri linguaggi, è usata solo per 
mantenere ordinato il codice, ed è lasciata a 
discrezione del programmatore. In Python, al 
contrario, l'indentazione sostituisce i blocchi 
delimitati da parentesi per la strutturazione del 
codice. Python, in parole povere, costringe il pro- 



grammatore a mantenere ordinati i propri sor- 
genti. Alcuni puristi ritengono la scelta un grado 
di libertà in meno, altri sviluppatori trovano l'i- 
dea semplicemente noiosa, ma molti altri ne 
apprezzano i vantaggi. 

NELLA PROGRAMMAZI 
ONE MODERNA 

Python piace molto agli sviluppatori, soprattutto 
a quelli degli ambienti del Software Libero e 
dell'Open Source. Facendo un giro su Source- 
Forge.net è possibile verificare l'affermazione. Se 
questo non bastasse, vi elenco alcuni nomi 
famosi che fanno uso di Python: Google, Yahoo, 
IBM, Red Hat (Anaconda, il loro tool di installa- 
zione e configurazione del sistema operativo, è 
realizzato in buona parte con Python), NASA e 
Industriai Light & Magic (quelli degli effetti spe- 
ciali di StarWars, per intenderci). 

PYTHON ITALIA 

Il principale sito di riferimento per Python, al 
quale fa capo tutto il mondo, è http://www.py- 
thon.org/, naturalmente in lingua inglese. 
L'Italia è rimasta inizialmente insensibile al 
fascino di Python, fin quando dalla fine del seco- 
lo scorso è andata a formarsi la prima comunità 
di sviluppatori amanti di questo linguaggio. Il 
risultato di questo incontro è dato dal sito 
Python Italia (http://www.python.itl) e dal 
newsgroup it.comp.lang.python. Il sito, in parti- 
colar modo, rappresenta il principale punto di 
riferimento per gli sviluppatori Python di casa 
nostra. Da Python Italia è possibile arrivare velo- 
cemente al download degli interpreti del lin- 
guaggio e di tutti gli strumenti collegati. Il sito 
ospita inoltre guide, riferimenti, FAQ e tutorial in 
lingua italiana. Alcune sezioni risultano ancora 
incomplete ed in lavorazione. L'augurio è che la 
comunità possa crescere ed espandersi rapida- 
mente, per dare a Python lo spazio e la visibilità 
che indubbiamente il linguaggio merita anche in 
Italia. 

Carlo Pelliccia 
carlo.pelliccia@ioprogrammo.it 
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L'esp erto risponde. .. 



Pulsanti grassi in C++ 

Ciao ragazzi, volevo sapere se è 
possibile, e in caso come si fa, a 
mettere il testo bold sui pulsanti! 
Ciao e Grazie! 

All'interno della OnlnitDialog della tua 
finestra, aggiungi il seguente codice: 

BOOL CDialogo: :OnInitDialog() 

{ CDialog::OnInitDialog(); 

// TODO: Add extra initialization here 
CFont * mFont; 
mFont = new CFont; 
mFont->CreateFont(/*int nHeight*/ 14, 

/*int nWidth*/ 0, /*int nEscapement*/ 0, 
/*int nOrientation*/ 0, /*int nWeight*/ 

FW_EXTRABOLD, /*BYTE bltalic*/ 0, /* 

BYTE bUnderline*/ 0, 

/*BYTE cStrikeOut*/ 0, /*BYTE nCharSet*/ 

DEFAULT_CHARSET, 

/*BYTE nOutPrecision*/ OUT_CHARACTER_PRECIS, 
/* BYTE nClipPrecision */ 

CLIP_CHARACTER_PRECIS, 

/*BYTE nQuality*/ DEFAULT_QUALITY, 

/*BYTE nPitchAndFamily*/ 

DEFAULT_PITCH | FF_DONTCARE, 

/*LPCTSTR IpszFacename*/ _T("Arial")); 
CWnd * pwnd = this->GetDlgItem(IDOK); 
// ID del pulsante di cui vuoi modificare il font 

pwnd->SetFont(mFont,TRUE); 

return TRUE; // return TRUE unless you set 

the focus to a control 
// EXCEPTION: OCX Property Pages should 

return FALSE } 

Per modificare i parametri del font, studia- 
ti il metodo CreateFont della classe CFont... 

Rappresentazioni 
isometriche con DirectX 

Ho letto con attenzione il primo 
articolo su DirectX comparso 
nel numero di Febbraio di 
ioProgrammo. Grazie agli articoli ed 
ai tutorial ho potuto testare facil- 
mente le funzionalità di base di 
DirectX. Ho riscontrato subito un 
problema: è possibile ottenere una 



rappresentazione isometrica, quindi 
non prospettica? Ponendo la came- 
ra molto distante e un angolo di 
vista molto stretto si raggiunge una 
approssimazione della vista isome- 
trica, ma ho paura che poi si perda 
nella precisione dei calcoli perché la 
matrice di proiezione viene malcon- 
dizionata. Ha qualche suggerimen- 
to da fornirmi? 

Paolo Braschi 
Risponde Carlo Zoffoli 

Hai assolutamente ragione, infatti non 
si usa Direct3D per i giochi isometri- 
ci, ma DirectDraw (che non è assoluta- 
mente una libreria sorpassata). Fra l'altro, 
usare Direct3D nelle isometrie è un enor- 
me spreco di risorse: con DirectDraw puoi 
caricare quattro bitmap per ogni, ad 
esempio, personaggio che vuoi rappresen- 
tare e scegli quale caricare a seconda se il 
personaggio in questione "punta" verso 
l'alto, il basso, a destra o a sinistra. E così 
per ogni altro oggetto in movimento nel 
gioco isometrico. Permettimi di consi- 
gliarti "Isometrie Game Programming 
with DirectX 7.0 w/CD" di Ernest Pazera, et 
al (Paperback), che puoi trovare su Ama- 
zon.com. Anche se parla di DirectX 7 e di 
C++ è comunque un buon riferimento 
(DirectDraw non è quasi per niente cam- 
biato dalla versione 7, e le chiamate C++ 
sono molto simili a quelle C#). Comunque 
se continui a seguire gli articoli su DirectX 
in .NET di ioProgrammo vedrai che verrà 
affrontato anche questo argomento, più in 
là. 

I "profani" di J2EE 

Scusate la banalità della doman- 
da, ma non mi sono ancora but- 
tato nel mondo Enterprise di Java: 
che significa esattamente il termine 
"deploy" ? 

Matteo Difuria 
Risponde Krystal 

La fase di "deploy" altro non fa che "in- 
stallare" la web application creata sul 
particolare Application Server utilizzato. 
In genere "deployare" assume un senso 



concreto in presenza di EJB (Enterprise 
lavaBeans), che non vengono solo "copia- 
ti" nella cartella giusta del proprio Appli- 
cation Server, ma anche "configurati" (in 
genere tramite file XML), al fine di essere 
resi operativi e utilizzati correttamente 
dall'Application Server (e purtroppo ogni 
Application Server ha la sua semantica e i 
suoi tool di configurazione). 

Processi figli e demoni 

Salve a tutti! Vi espongo il mio 
problema: in C ho fatto un pro- 
gramma che genera dei processi 
figli e comunica con loro tramite 
pipe e socket. il programma in que- 
stione crea anche un processo che 
resterà poi orfano diventando 
demone. La mia domanda ora è 
questa: come gestire creazione can- 
cellazione etc... dei processi con 
Java? Si può fare vero? 
Grazie a tutti!! 
Risponde Krystal 

Java supporta unicamente Thread. Co- 
me è facile immaginarsi, un Thread è 
anch'esso un oggetto e nel particolare. Per 
"creare" un Thread hai 2 alternative: 

a) implementare l'interfaccia java.lang. 
Runnable (e di conseguenza il metodo 
"raw"che contiene il codice da esegui- 
re..) e passare tale classe come argo- 
mento ad uno dei costruttori di Thread 
(Thread (Runnable target), ad esempio) 

class TuaClasse implements Runnable 

{■■■ 

public void run() 

{ ■■■}} 

//successivamente (nel main ad esempio) 
TuaClasse tua = new TuaClasse(); 
new Thread(tua).start(); 

b) estendere direttamente java. lang. Thread 
ridefmendo opportunamente il meto- 
do "run" (in effetti Thread implementa 
a sua volta Runnable... ) 

• per "eseguire" un Thread basta richia- 
mare il metodo "start" 
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class TuaClasse extends Thread 

{■■■ 

public void run() 

{ ■■■} 

} 

//successivamente (nel main ad esempio) 
TuaClasse tua = new TuaClasseQ; 
tua.start(); 

• per "interrompere" un Thread basta 
richiamare su di esso il metodo inter- 
ruptO; 

• per "tante altre cose" ti consiglio viva- 
mente di dare uno sguardo alla docu- 
mentazione ufficiale che trovi anche al 
link http://java.sun.eom/j2se/l.5.0/docs/ api/, 
cercando "Thread" tra "AUClasses". 

P.S. Potrebbe esserti utile metodo setDae- 
mon e, se sei interessato a gestire contem- 
poraneamente + Thread, dai uno sguardo 
anche a "ThreadGroup" (per cambiare la 
priorità ad un gruppo di Thread, ad esem- 
pio). 

VB.NET, setup 

di un'applicazione 

Ciao a tutti! Ho la necessità di di- 
stribuire la mia applicazione sal- 
vata su un CD a n persone; sui PC di 
queste n persone non è installato 
vb.net né .net framework. Lancian- 
do il setup di installazione dell'ap- 
plicazione viene richiesta anche l'in- 
stallazione di .net framework. Mi 
piacerebbe evitare alle persone di 
dover seguire una sequenza di pas- 
si per l'installazione facendo loro 
lanciare solo l'eseguibile del mio se- 
tup. 

Qualcuno sa dirmi come includere 
.net framework nel setup di in- 
stallazione di un'applicazione? Rin- 
grazio anticipatamente, ciao. 

Dalù 
Risponde Fabio Cozzolìno 

Devi utilizzare il bootstrapper .NET. 
Puoi trovare il plug-in e le instruzioni 
a questo indirizzo: http:llmsdn.microsoft.com 
lvstudioldownlo...slbootstrapperl 

Button in VB.NET 



In VB6 i commandbutton prevede- 
vano la proprietà' tooltiptext. In 
VB.NET tra le proprietà dei button 
non ho trovato niente di simile. 



non esiste qualcosa di simile? 
Ciao e grazie 

Risponde Fabio Cozzolìno 

In VB.Net questa funzionalità è stata so- 
stituita con il controllo ToolTip. Questo 
permette un maggiore controllo oltre alla 
possibilità di usufruire di uno strumento 
molto più potente. Devi quindi aggiunge- 
re un controllo ToolTip al tuo form e colle- 
garlo ai vari controlli da implementare. 
Questo è un esempio tratto da MSDN: 

Private Sub Forml_Load(sender As Object, e 
As System. EventArgs) Handles MyBase.Load 
' Create the ToolTip and associate with the 

Form container. 
Dim toolTipl As New ToolTip() 
' Set up the delays for the ToolTip. 

toolTipl. AutoPopDelay = 5000 

toolTipl. InitialDelay = 1000 

toolTipl. ReshowDelay = 500 

' Force the ToolTip text to be displayed 

whether or not the form is active. 
toolTipl. ShowAIways = True 
' Set up the ToolTip text for the Button and 

Checkbox. 
toolTipl. SetToolTip(Me.buttonl, "My buttonl") 
toolTipl.SetToolTip(Me.checkBoxl, "My 

checkBoxl") 
End Sub 

ovviamente sulla documentazione del fra- 
mework trovi una marea di informazioni. 

Esistenza file in C# 

Salve a tutti, come faccio a verifi- 
care se esiste un determinato 
file nella directory principale del- 
l'applicazione?!? In vb.net uso dir 
qual'è l'equivalente in c#? Grazie 

Beziel 
Risponde Antonio Pelleriti 

Puoi utilizzare il metodo statico Exists 
della classe File, ad esempio: 

if (File.Exists(percorso)) 

{ 

//il file esiste 

} 



Microsoft Agent 



Ho trovato molto interessante 
l'articolo sulla rivista riguardan- 
te Agent, ed ho subito fatto qual- 
che prova, ma la voce dei perso- 
naggi è sempre la stessa e ciò 



rende la cosa meno friendly, dun- 
que mi kiedevo se fosse possibile 
cambiare la voce dei personaggi. 

Master 

risponde Roberto Allegra 

Ciao, ti ringrazio per l'apprezzamento. 
Purtroppo per motivi di spazio non è 
stato possibile pubblicare un laterale che 
riguardava la questione voci/engines. 
Per trattarla bene ci vorrebbe molto spa- 
zio, e molto tempo (un articolo a parte). 
Agent si basa sui TTS quindi, ottenendo l'i- 
dentificativo del motore (tramite Speech 
API o controllo Text-To-Speech), puoi cam- 
biare il set per la voce, usandone un 
modelD precompilato. Per le L&H i valori 
predefiniti sono i seguenti: 

Barbara, Italian, L&H TTS3000 { 

7EF71700-A92D-lldl-B17B-0020AFED142E} 
Stefano, Italian, L&H TTS3000 { 

7EF71701-A92D-lldl-B17B-0020AFED142E} 

Puoi inoltre cambiare i valori di Pitch e 
Speed, anche se non direttamente da con- 
trollo. 

Per cambiare i valori di un personaggio già 
esistente "in corsa" puoi usare i tag: 

"\spd = 180\Ciaol", ad esempio, imposta la 
velocità 180 per la stringa in questione. 

Puoi comodamente impostare per il per- 
sonaggio una stringa default corrispon- 
dente ad un insieme di tag che definisco- 
no il personaggio, ad esempio: 

VoceMerlin = "\spd = 180\\pit=150\" 

e poi richiamarla quando ti serve, asso- 
ciandola al metodo speak 

Merlin. Speak VoceMerlin & "Ciao!" 

Questo è un modo molto comodo di risol- 
vere la questione. Nel caso in cui sia tu a 
creare un personaggio nuovo tramite ACE 
(prossimo articolo) puoi decidere i valori 
da associare per default a velocità e pitch. 
Ti consiglio di scaricare l'SDK di Agent, c'è 
una buona sezione sull'argomento. 
Ciao 

PER CONTATTARCI 

e-mail: ioprogrammo@edmaster. it 

Posta: Edizioni Master, 

Via Cesare Correnti, 1 - 20123 Milano 
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WEB DEVELOPER 

Un sito dedicato a tutti gli svi- 
luppatori web e a chi vuole 
diventarlo; una vasta sezione 
dedicata a CSS, DHTML, HTML, 
.NET, XML, ASP, PERL, JavaScript, 



Biblioteca 

FLASHMX 2004 ACTIOiUSCRIPT 

Il corso ufficiale per i principianti e intermedi di Flash MX 2004 Action- 
Script. Lezioni passo passo, progetti concreti e spiegazioni complete per 
percepire la logica che sta dietro gli script e per capire come, coordinati tra 
loro, completino un progetto. Chi conosce già ActionScript LO, si accorgerà 
che la versione 2.0 non è molto diversa, salvo alcune piccole ma essenziali 
differenze. Tra gli argomenti trattati: 

• La nuova sintassi di ActionScript 2.0. 

• Classi di oggetti predeflnite (Color, Sound e Array) e classi personalizzate 

• Utilizzazione ed elaborazione dei dati nei progetti. 

• Progettazione con la logica condizionale. 

• Creazione di un'interfaccia interattiva. 

• Creazione di un'applicazione chat a più stanze usando un server socket 
XML. 

• Stampa del contenuto Flash in modo interattivo. 

Il CD-ROM allegato contiene i file necessari per completare i progetti e veri- 
ficarli con i risultati ottenuti. 

Difficoltà: Media • Autori: Derek Franklin - Jobe Makar • Editore: Mondadori Informatica 
http://education.mondadori.it • ISBN: 88-04-53127-4 • Anno di pubblicazione: 2004 • Lingua: Italiano 
Pagine: 784 • Prezzo: € 50.00 
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PYTHON 

Python è stata una parte impor- 
tante in Google sin dall'inizio, e 
rimane tale mentre il sistema 
cresce e si evolve. Oggi dozzine 
di ingegneri di Google usano 
Python, e stiamo cercando sem- 
pre più gente brava in questo 
linguaggio." dice Peter Norvig, 
direttore della qualità di ricerca 
al Google center. 



farOfttsn^ 





www.Dvthon.it 



ACKY 

Tutorial, archivi, forum per 
JavaScript, Visual Basic, CGI 
Scripts, PhotoShop, Flash, HTML, 
Visual Basic, Perl 




INTERMEDIATE ROBOT BUILDING 

Per gli amanti della robotica APress propone il seguito di "Robot Building 
for Beginners". Il testo offre un apprendimento "real-world", in condizio- 
ni reali, che solo un veterano costruttore di Robot può offrire. Chi masti- 
ca l'inglese non avrà problemi a capire le tecniche giuste per creare robot 
esploratori o combattenti capaci di evitare ogni ostacolo, senza rischiare 
di far esplodere i condensatori! Le istruzioni passo passo, gli schemi det- 
tagliati dei circuiti, una gran quantità di foto descrittive, i meccanismi 
più ingegnosi vi permetteranno di evitare ogni errore. Lo stile di scrittura 
è estremamente semplice da capire, in poche mosse diventerete provetti 

"Robot Builder". 

Difficoltà: Media • Autore: David Cook • Editore: Apress www.apress.com • ISBN: 1-59059-373-1 
Anno di pubblicazione: 2004 • Lingua: Inglese • Pagine: 442 • Prezzo: S 34.99 

L'ARTE DELL'HACKING 

Il primo vero manuale che spiega le tecniche di hacking più diffuse, senza 
tralasciare alcun dettaglio tecnico. Partendo dal presupposto che conoscere 
i metodi di attacco possa rappresentare un'arma in più di difesa, fon 
Erickson guida il lettore esperto in un vero e proprio percorso di iniziazione 
alle tecniche hacker. Scritto in un modo chiaro, conciso e organizzato, que- 
sto libro vi spiegherà come: 

• Sfruttare buffer overflow e format string per creare gli exploit 

• Scrivere shellcode polimorfico stampabile in ASCII 

• Sconfiggere i meccanismi di protezione dello stack tramite il ritorno alla 
libc 

• Redirezionare il traffico di rete, nascondere le porte aperte e dirottare le 
connessioni TCP 

• Decifrare il traffico criptato su reti wireless 802. 1 lb mediante l'attacco 
FMS 

Difficoltà: Medio-Alta • Autore: Jon Erickson • Editore: Apogeo www.apogeonline.cotn 
ISBN: 88-503-2280-1 • Anno di pubblicazione: 2004 • Lingua: Italiano • Pagine: 256 
Prezzo: € 24.00 
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